Text to Video

Генеруйте відео з текстових prompt через Kling за допомогою CometAPI POST /kling/v1/videos/text2video, а потім відстежуйте статус задачі й отримуйте результати за ID задачі.

POST /kling/v1/videos/text2video

Text to Video

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A happy scene of a vacation on the beach."
}
'

200

{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Використовуйте цей endpoint, щоб створити задачу Kling для генерації відео з текстового prompt. Він запускає асинхронне завдання, а не повертає готове відео одразу.

​

Перший робочий запит

• Спочатку надішліть короткий prompt
• Додавайте aspect_ratio, duration або mode лише після того, як базовий сценарій запрацює
• Вкажіть callback_url, якщо хочете отримувати результат через push-доставку замість чистого polling

​

Потік задачі

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

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

2. Опитуйте стан задачі

   Перевіряйте прогрес через Individual Queries, доки задача не досягне фінального стану.

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

   Щойно Kling поверне метадані готового asset, перемістіть результат у власне сховище, якщо вам потрібне довготривале зберігання.

Для повної матриці параметрів і деталей model-track зверніться до офіційної документації Kling. Форми запиту та відповіді на цій сторінці використовуйте як довідник щодо обгортки CometAPI.

Авторизації

Authorization · string · header · обов'язково

Bearer token authentication. Use your CometAPI key.

Заголовки

Content-Type · string

Must be application/json.

Тіло

application/json

prompt · string · за замовчуванням: Hello · обов'язково

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

negative_prompt · string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio · string

Output aspect ratio (width:height). Options: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

callback_url · string

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

model_name · string

Kling model variant to use. See the Models page for current options.

cfg_scale · number

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

mode · enum<string>

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

Доступні опції: std, pro

duration · string

Output video length in seconds. Options: 5, 10.

camera_control · object

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

Show child attributes

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.

Відповідь

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

Show child attributes