kling-v1-6
Профиль kling-v1-6 генерирует видео по текстовому описанию сцены. Спланируйте короткий кадр с ясным объектом, действием и направлением камеры, используя документированные варианты длительности в пять или десять секунд. Генерация асинхронна: сохраняйте возвращённый идентификатор задания и получайте готовое видео после успешного завершения исходного задания.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Точный селектор kling-v1-6 обозначает профиль Kling для создания видео по тексту. Отправьте JSON в POST /v1/videos/generations с model, равным kling-v1-6, и текстовым описанием сцены в prompt. POST /v1/videos также принимает тот же запрос генерации. Ясный запрос описывает, что видно, что происходит во время кадра и как камера это наблюдает. Минимальный запрос сцены передаёт селектор модели и prompt, оставляя дополнительные параметры кадра незаданными.
Для кадра с продуктом опишите объект, поверхность, освещение и одно видимое действие, например медленный поворот или изменение положения камеры. Для концепции сцены укажите окружение, главный объект и движение в кадре. Действие должно оставаться понятным в пределах запрошенного ролика. Запрос может описывать небольшую лодку, пересекающую тихое озеро, общий вид с берега, ранний утренний свет и устойчивую камеру, следующую по направлению движения лодки.
Предел prompt — 500 символов. Необязательный negative_prompt может содержать до 200 символов и описывает нежелательные элементы. Документированные варианты duration для этого профиля — 5 и 10 секунд. Значения mode — std и pro. cfg_scale — число от 0 до 1; документация описывает более высокие значения как более строгое следование тексту. Выбирайте параметры для конкретного кадра и сохраняйте отправленные значения вместе с результатом.
Документированный объект camera_control перечисляет типы камеры simple, down_back, forward_up, right_turn_forward и left_turn_forward. Его конфигурация simple называет параметры horizontal, vertical, pan, tilt, roll и zoom. Минимальный текстовый пример даёт полезную отправную точку, если сцену можно описать без отдельного объекта управления камерой. Задайте движению камеры ясную цель в запросе, например раскрытие объекта или следование его движению.
Отправка запускает асинхронное задание. Сохраните возвращённый id, заголовок X-Ailoot-Task-Id и polling_url, затем используйте GET по этому polling_url с тем же API-ключом Ailoot, чтобы прочитать исходное задание. Состояние задания находится в data.task_status: submitted и processing означают ожидание, succeed — успех, failed — неуспех. Поэтому подтверждение отправки является промежуточным результатом. После успеха загрузите каждый URL из data.task_result.videos[].url; это ссылки на файлы результатов под управлением Ailoot. GET /v1/videos/{id}/content получает первый результат, а параметр запроса index выбирает возвращённый результат по индексу, начинающемуся с нуля. Сохраняйте ответ о статусе вместе с выбранным роликом. Если происходит тайм-аут или приходит ответ result_pending_check, сохраните исходный возвращённый идентификатор и проверьте эту операцию вместо повторной отправки кадра.
Проверьте готовое видео по всей длительности: задуманное действие, внешний вид объекта, кадрирование и движение входят в задание кадра. Этот конкретный профиль предоставляет описанный здесь процесс создания видео по тексту. Возвращённое задание, которому всё ещё нужна проверка статуса, следует отслеживать по его исходному идентификатору, в том числе при тайм-ауте клиентского запроса; сохраняйте сведения о задании перед рассмотрением нового запроса генерации.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Начало
Профиль kling-v1-6 генерирует видео по текстовому описанию сцены. Спланируйте короткий кадр с ясным объектом, действием и направлением камеры, используя документированные варианты длительности в пять или десять секунд. Генерация асинхронна: сохраняйте возвращённый идентификатор задания и получайте готовое видео после успешного завершения исходного задания.
- Допустимые входные данные
- Текст
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Video POST /v1/videos
- Входные данные
text- Результат
video
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения kling-v1-6 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеmode | Типstring | ТребованиеОбязательно | Значения и ограничения std, pro | По умолчанию— |
Полеmodel_name | Типstring | ТребованиеНеобязательно | Значения и ограничения kling-v1-6 | По умолчанию— |
Полеcfg_scale | Типnumber | ТребованиеНеобязательно | Значения и ограничения Минимум: 0 Максимум: 1 | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеnegative_prompt | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеduration | Типinteger | ТребованиеНеобязательно | Значения и ограничения 5, 10 | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, mode |
Параметрoptional | Контрактmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Параметрmaterial_types | Контрактtext |
Параметрconditions | Контрактmodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
Псевдонимы метода: /v1/videos/generations
Жизненный цикл: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияEstimated generation cost | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Вход · Оценочная стоимость генерации · Оценка только для сравнения $6 оценка до генерации This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Если нужно проверить исходный ответ
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Поля ответа
| Поле | Тип |
|---|---|
Полеdata.task_result.videos[].url | Типstring or array, as returned |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra kling-v1-6
Псевдонимы путей метода
/v1/videos/generations
Связанные ID для вызова
FAQ · kling-v1-6
- Какие входные данные и результаты доступны?
POST /v1/videos·kling-v1-6:text→video- Какие поля использует запрос?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Какие ограничения действуют?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1