Skip to main content
POST
cURL
Используйте этот endpoint, чтобы создать задачу Kling text-to-video из Prompt. Он запускает асинхронную задачу, а не возвращает готовое видео сразу.

Первый рабочий запрос

  • Сначала отправьте короткий Prompt
  • Начните с примера kling-v3, затем выберите другой model_name из enum в OpenAPI, когда вам понадобится другая линейка моделей
  • Добавляйте aspect_ratio, duration, mode или sound только после того, как базовый сценарий заработает
  • Укажите callback_url, если хотите получать результат через push-доставку, а не только через polling
  • Используйте sound: off, если вам нужен детерминированный первый запрос без аудио на моделях, которые поддерживают генерацию звука

Именование моделей

Используйте в этом endpoint обычные model ID видеомоделей Kling. model ID моделей Omni оставьте для Omni Video.

Длительность и соотношение сторон

Этот endpoint не предоставляет отдельный токен разрешения или точное поле size. Запрошенное соотношение сторон управляет формой выходного кадра.

Поток выполнения задачи

1

Отправьте запрос на генерацию

Создайте задачу через этот endpoint и сохраните возвращённый id задачи Kling.
2

Опросите состояние задачи

Проверяйте прогресс через Получение задачи Kling, пока задача не перейдёт в конечное состояние.
3

Сохраните результат

Когда Kling вернёт метаданные готового ассета, переместите результат в собственное хранилище, если вам нужно долгое хранение.
Полную матрицу параметров и подробности по линейкам моделей смотрите в официальной документации Kling.

Авторизации

Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Заголовки

Content-Type
string

Must be application/json.

Тело

application/json
prompt
string
обязательно

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.

Доступные опции:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates when the task completes.

model_name
enum<string>
по умолчанию:kling-v1

Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.

Доступные опции:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

mode
enum<string>
по умолчанию:std

Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.

Доступные опции:
std,
pro
duration
string
по умолчанию:5

Output video length in seconds. Use 5 or 10; omit to use 5.

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

external_task_id
string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Доступные опции:
on,
off

Ответ

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object