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, якщо вам потрібен детермінований перший запит без аудіо на моделях, що підтримують згенерований звук

Називання моделей

Використовуйте звичайні model ID відеомоделей Kling на цьому endpoint. Залишайте model ID Omni для Omni Video.

Тривалість і співвідношення сторін

Цей endpoint не надає окремий токен роздільної здатності або точне поле size. Запитане співвідношення сторін керує формою вихідного кадру.

Потік завдання

1

Надішліть запит на генерацію

Створіть завдання через цей endpoint і збережіть повернутий id завдання Kling.
2

Опитуйте стан завдання

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

Збережіть результат

Щойно Kling поверне метадані готового asset, перемістіть результат у власне сховище, якщо вам потрібне довготривале зберігання.
Для повної матриці параметрів і деталей щодо гілок моделей зверніться до офіційної документації 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