Введение
Kling 3.0 Turbo Text to video превращает текстовое описание сцены в клип от 3 до 15 целых секунд, в 720p или 1080p, со звуком, сгенерированным за тот же проход. У этого эндпоинта нет беззвучного режима: опишите в промпте нужный диалог и фоновый звук, и они рендерятся вместе с картинкой.
Выбор режима Kling 3.0 Turbo по стартовому материалу
| Что у вас есть на старте | Режим |
|---|---|
| текстовое описание сцены | Kling 3.0 Turbo текст в видео |
| утверждённое первое изображение | Kling 3.0 Turbo изображение в видео |
Ключевые возможности и особенности
Звук не опционален, и в этом суть
Каждый клип с этого эндпоинта несёт сгенерированную звуковую дорожку: реплики, поставленные в кавычки, рендерятся как произнесённые фразы, а любой названный фоновый звук — музыка, шаги, трафик — возвращается смешанным с картинкой. В наших тестах произнесённые реплики совпадали с промптом слово в слово в каждом запущенном клипе. Поля для отключения звука нет; для беззвучного клипа в 1080p используйте вместо этого Kling 2.5 Turbo.
Один непрерывный дубль, без поля монтажной склейки
У этого эндпоинта нет настройки мультиплана, поэтому каждый клип идёт как один неразрывный дубль. Опишите одно чёткое действие от начала до конца — танец, разбег и прыжок, поворот к камере, — а не несколько тактов, которые вы хотели бы сшить вместе.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Пишите как план: кто в кадре, действие, движение камеры, затем звук — реплики в кавычках и нужные фоновые звуки. Звук рендерится всегда; отключить его нельзя. Не менее 1 символов · Не более 2500 символов |
aspect_ratio | Нет | 16:9, 9:16 или 1:1. Выбирайте до написания промпта, чтобы бриф расставил субъект под этот формат кадра. |
resolution | Нет | 720p или 1080p. Более высокие уровни стоят дороже за секунду. |
duration_seconds | Нет | Целые секунды, от 3 до 15. Влияет на цену вместе с разрешением. |
Стоимость
Оплата за секунду выходного видео; разрешение и длительность оба влияют на ставку.
| Спецификация | Стоимость |
|---|---|
| $0.112 / секунду |
| $0.14 / секунду |
Сценарии использования
Диалоговые сцены для шортс и рилс
Двое разговаривающих, смеющихся или обменивающихся репликой людей хорошо работают здесь, поскольку звук возвращается синхронным с картинкой, а не озвученным позже. В протестированной нами кухонной сцене произнесённая реплика, фоновая музыка и звук булькающей кастрюли пришли в одном файле — без отдельного этапа озвучивания перед публикацией.
Экшен и движение с подходящим звуком
Паркур, танец и другое физическое действие приходят со встроенными в тот же файл, что и движение, шагами, ударами и дыханием, без отдельного прохода фоли.
Быстрые в производстве соцклипы, которым звук нужен с самого начала
Поскольку звук генерируется за тот же проход, что и картинка, этот эндпоинт подходит для любого короткого клипа, идущего прямо в ленту или рилс, где ожидание отдельного этапа саунд-дизайна замедлило бы публикацию.
Руководство по промптам и практические советы
Пишите план в том порядке, в котором это происходит
Стройте промпт как субъект, действие, камеру, затем звук. Промпт с сальсой на кухне — рабочий шаблон: кто танцует и во что одет, что они делают (кружение, столкновение со столешницей), камера (средний план, мягкая съёмка с рук), затем звук (музыка, смех, бульканье кастрюли).
Сопоставляйте звук с действием, а не только с настроением
Называйте звуки, вызванные чем-то в кадре — шаги по бетону, булькающая кастрюля, двигатель скутера, — а не общую атмосферную дорожку. В наших тестах звук, привязанный к видимому действию, рендерился более стабильно синхронно с картинкой, чем фоновая подсказка без ничего в кадре, что могло бы её производить.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0-turbo/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.











