Текст в видео

Отправляйте текстовые задачи в нативном формате Kling 4.0.

Промпт может описывать желательные и нежелательные элементы. settings задаёт длительность, разрешение и пропорции, options — обратный вызов и водяной знак.

POST/kling/text-to-video/kling-4.0

Kling 4.0 по промпту. Модель задаётся путём; поле model в теле не нужно.

Аутентификация

bearerAuth

АутентификацияBearer <token>

API Key платформы: Authorization: Bearer your-api-key.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

prompt*Prompt

Положительные и отрицательные описания в промпте. Только английский — до 26000 символов, только прочие — 11000. Смесь: E/26000 + N/11000 <= 1, E — английские символы, N — остальные.

settings?

options?

Тело ответа

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/text-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Светлый берег, камера медленно движется вперёд, волны мягко омывают песок.",
    "settings": {
      "duration": 3,
      "resolution": "720p"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

Частые ошибки и решения

Ответ или ошибка	Проверка и действие
HTTP 401, `Invalid token`	Проверьте Bearer и принадлежность API Key сайту
HTTP 400, `prompt cannot be empty`	Передайте непустой текстовый промпт
HTTP 400, `prompt value type is invalid`	`prompt` должен быть строкой, не массивом или объектом
HTTP 400, `invalid_request`	Проверьте типы, включая `settings.duration`; длительность — целое число
HTTP 400, ошибка разрешения/пропорций	Используйте допустимые значения `settings.resolution` и `settings.aspect_ratio` из таблицы
HTTP 400, `invalid JSON request body`	Проверьте JSON и удалите комментарии

Общая проверка может перечислять больше значений, чем поддерживает модель. Используйте целую длительность 3～30 секунд и 720p либо 1080p. Не выводите поддержку других значений только из текста ошибки.

Ошибка создания может вернуть code/message/data или объект error вместо структуры успеха. Причина fail_to_fetch_task указана в message, возможно JSON-строке с code/message/request_id. Сохраните ID запроса, не передавайте API Key.

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

Частые ошибки и решения

`application/json`

`application/json`

`application/json`