Kling: Video v3.0 Pro

Kling VIDEO 3.0 Pro — профессиональный профиль Kuaishou в 1080p для сцен по тексту и изображениям. Он сочетает клипы от трёх до пятнадцати секунд, встроенное аудио, граничные кадры и режиссуру одного или нескольких планов для кинематографических концепций и коротких постановок.

Ailoot Ultra · Видео POST /v1/videos kwaivgi/kling-v3.0-pro

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Kling VIDEO 3.0 Pro — профессиональный профиль модели VIDEO 3.0 Kuaishou. Документированный Pro создаёт 1080p по тексту или изображению, длиной от трёх до пятнадцати секунд. Версия 3.0 сочетает встроенный звук, постоянство объектов и многоплановую режиссуру для ясного задания внешности, действия, набора планов и ракурсов, а также звука короткой постановки.

Начните с основного действия. В текстовом плане опишите объект, окружение, свет и точку зрения, делающую действие понятным. В изображении начало задаёт внешность и композицию, текст — изменение во времени. Для продуктовой концепции подготовленный кадр показывает предмет на студийной поверхности, промпт — медленное раскрытие материала и формы.

Многоплановая режиссура предлагает автоматический выбор планов и ракурсов или пользовательскую последовательность. Автоматический режим планирует смену кадра и ракурса по заданию; сцена может оставаться одним непрерывным планом. Пользовательская раскадровка задаёт содержание и длительность каждого. Профиль допускает один–шесть планов, до 512 символов и минимум одну секунду на каждый; сумма равна общей длине.

Короткий сюжет разделите на установочный вид, основное действие и завершающую деталь. Назовите камеру и то, что нужно заметить в каждом. Внешность повторяющегося объекта сохраняйте, действия, планы и ракурсы меняйте намеренно. Единый промпт справочника — до 2 500 символов; пользовательская последовательность использует отдельные описания планов.

Референсы поддерживают узнаваемость персонажа, продукта или места в сцене по изображению. Выбирайте ясные ракурсы нужных признаков, единообразно называйте объекты. Профиль допускает до трёх подготовленных элементов. Сосредоточьте роли вместо объединения материалов с конфликтующей внешностью.

Первый и последний кадры задают визуальные границы перехода. Они должны согласовываться по объекту и сцене; опишите связывающее движение. Поддержаны JPG, JPEG, PNG, до 10 MB, минимум 300 пикселей, отношение первого кадра между 1:2.5 и 2.5:1. Граничные кадры и пользовательская раскадровка обрабатывают вход по-разному, поэтому организуйте материал под сценарий до полного задания.

Встроенное аудио сочетает реплики, атмосферу и визуальное исполнение. В справочнике оно выключено по умолчанию и включается для аудиовизуальной сцены. Языковой профиль 3.0 включает китайский, английский, японский, корейский и испанский, переключение языков и поддерживаемые диалекты или акценты. Руководство говорит: диалог на другом языке переводится на английский. Закрепляйте каждую реплику за нужным говорящим, отделяйте диалог от фона, объясняя говорящего и окружающий звук.

Пример двух персонажей задаёт Speaker A и Speaker B, короткую реплику каждому и видимый ответ между ними. Диалог должен соответствовать длине; при смене вида называйте говорящего. Голосовая режиссура и референс персонажа имеют разные роли: задайте исполнение, не предполагая, что изображение содержит произносимые слова.

VIDEO 3.0 улучшает видимые надписи в сценах по изображению. Если важны знак, этикетка или подпись, назовите их и сохраняйте вид референса. Проверьте написание, читаемость и движение, особенно для продуктового или рекламного сообщения. Возможность генерации надписей не заменяет финальную проверку.

Pro — 1080p, Standard — 720p. Отдельно выбранный 4K — иной профиль, поэтому Pro не означает все высокие разрешения. Текстовый режим документирует 16:9, 9:16 и 1:1. Выберите кадр под размещение с читаемой композицией.

Генерация выполняется задачей, успешный результат выдаёт готовое видео и фактическую длительность. Документация говорит об удалении через 30 дней, сохраняйте своевременно. Храните клип, задание и референсы; проверяйте постоянство объектов, порядок планов, камеру, диалог и надписи. Используйте выбранное видео как кинематографическую концепцию, продуктовую сцену или сюжет, точечно исправляя несоответствующую часть.

Ailoot Ultra · Видео POST /v1/videos kwaivgi/kling-v3.0-pro

kwaivgi/kling-v3.0-pro

Kuaishou /kwaivgi/kling-v3.0-pro

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Видео

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Видео POST /v1/videos

Входные данные: text, image
Результат: video
Выходной формат: Исходные байты MP4; без нормализации и перекодирования

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения kwaivgi/kling-v3.0-pro	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения	По умолчанию—
Поле`duration`	Тип`integer`	ТребованиеОбязательно	Значения и ограничения 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Минимум: 1 Максимум: 600	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 720p	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 16:9, 9:16, 1:1	По умолчанию—
Поле`generate_audio`	Тип`boolean`	ТребованиеНеобязательно	Значения и ограничения false, true Условия: Отсутствие этого параметра выбирает цену с аудио. Укажите false, чтобы выбрать цену без аудио. Проверьте has_audio в результате, чтобы узнать, возвращена ли аудиодорожка.	По умолчанию—
Поле`frame_images`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Минимум элементов: 1 Максимум элементов: 2 Входное содержимое: Массив объектов кадров. Каждый объект содержит type=image_url, image_url с url и frame_type. Используйте HTTPS URL изображения и укажите first_frame или last_frame в frame_type. Каждая роль кадра встречается не более одного раза. Точные ключи: type, image_url, frame_type Условия: Эти ключи описывают каждый объект кадра; image_url содержит только url. Не передавайте frame_images для запроса только с текстом.	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—
Поле`size`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1280x720, 720x1280, 720x720 Шаблон: ^[1-9][0-9]x[1-9][0-9]$	По умолчанию—
Поле`callback_url`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения Шаблон: ^https://	По умолчанию—
Поле`session_id`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—
Поле`trace`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—
Поле`user`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—

Сочетания входных материалов

Из текста в видео · Текстовый запрос. · Обязательно: model, prompt, duration

Передайте prompt как текст, а duration — как целое число секунд. Выберите поддерживаемое разрешение; добавьте соотношение сторон или используйте размер из списка.

model: Тип: string · kwaivgi/kling-v3.0-pro

prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да

Из изображения в видео · Текстовый запрос и изображение первого кадра. · Обязательно: model, prompt, duration, frame_images

frame_images — массив. Каждый объект кадра содержит type, image_url и frame_type; image_url содержит url. Укажите image_url в type. Используйте first_frame с необязательным last_frame. Каждая роль кадра встречается не более одного раза. Для каждого кадра укажите публичный HTTPS URL изображения. Выберите поддерживаемое разрешение; добавьте соотношение сторон или используйте размер из списка.

Точные ключи: type, image_url, frame_type

model: Тип: string · kwaivgi/kling-v3.0-pro

prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt, duration
Параметр`material_types`	Контрактtext, image
Параметр`additional_properties`	Контрактfalse
Параметр`optional_controls`	Контрактresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Жизненный цикл: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Компонент платы	Разрешение референса	Режим референса	Референсное аудио	Расчётная единица	Условия расчёта	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Компонент платы—	Разрешение референса—	Режим референса—	Референсное аудио—	Расчётная единица—	Условия расчёта—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияВидеорезультат · Справочная ставка	Шкала ставок—	Прогноз количества—	Компонент платы`reference_output_rate`	Разрешение референса—	Режим референса—	Референсное аудио—	Расчётная единицаза секунду результата	Условия расчёта—	Плата Выход · Справочный тариф за секунду выходного видео · Оценка только для сравнения $0.224 за секунду результата
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Компонент платы—	Разрешение референса—	Режим референса—	Референсное аудио—	Расчётная единицаза секунду видео	Условия расчётааудио: with_audio	Плата Выход · Цена видео · Оценка только для сравнения $0.336 за секунду видео
КонфигурацияВидео из изображения (кадры) · 1080p · Справочная ставка	Шкала ставок—	Прогноз количества—	Компонент платы`reference_output_rate`	Разрешение референса1080p	Режим референсаИз изображения в видео (изображения кадров)	Референсное аудиоБез аудио	Расчётная единицаза секунду результата	Условия расчёта—	Плата Выход · Справочный тариф за секунду выходного видео · Оценка только для сравнения $0.224 за секунду результата
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Компонент платы—	Разрешение референса—	Режим референса—	Референсное аудио—	Расчётная единицаза секунду видео	Условия расчётарежим генерации: image_to_video; разрешение: 720p	Плата Выход · Цена видео · Оценка только для сравнения $0.224 за секунду видео
КонфигурацияВидео из текста · 1080p · Справочная ставка	Шкала ставок—	Прогноз количества—	Компонент платы`reference_output_rate`	Разрешение референса1080p	Режим референсаИз текста в видео	Референсное аудиоБез аудио	Расчётная единицаза секунду результата	Условия расчёта—	Плата Выход · Справочный тариф за секунду выходного видео · Оценка только для сравнения $0.224 за секунду результата
КонфигурацияВидео из текста · 480p · Справочная ставка	Шкала ставок—	Прогноз количества—	Компонент платы`reference_output_rate`	Разрешение референса480p	Режим референсаИз текста в видео	Референсное аудиоБез аудио	Расчётная единицаза секунду результата	Условия расчёта—	Плата Выход · Справочный тариф за секунду выходного видео · Оценка только для сравнения $0.224 за секунду результата
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Компонент платы—	Разрешение референса—	Режим референса—	Референсное аудио—	Расчётная единицаза секунду видео	Условия расчётарежим генерации: text_to_video; разрешение: 720p	Плата Выход · Цена видео · Оценка только для сравнения $0.224 за секунду видео
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Компонент платы—	Разрешение референса—	Режим референса—	Референсное аудио—	Расчётная единица—	Условия расчёта—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.672 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Сведения о справочном тарифе

Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.

Ссылки на цены конфигураций видео

Цены по конфигурациям

Конфигурация	Условия расчёта	Плата
КонфигурацияЦена видео	Условия расчётаВ этом ключе цены дополнительное условие не объявлено.	Плата Выход · Цена видео $0.224 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётааудио: with_audio	Плата Выход · Цена видео $0.336 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётарежим генерации: text_to_video; разрешение: 480p	Плата Выход · Цена видео $0.224 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётарежим генерации: text_to_video; разрешение: 720p	Плата Выход · Цена видео $0.224 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётарежим генерации: image_to_video; разрешение: 720p	Плата Выход · Цена видео $0.224 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётарежим генерации: text_to_video; разрешение: 1080p	Плата Выход · Цена видео $0.224 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётарежим генерации: image_to_video; разрешение: 1080p	Плата Выход · Цена видео $0.224 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.

Примеры запросов

Ailoot Ultra · Видео

curl · создать видео

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Видео

подписанные ссылки на содержимое, принадлежащее Ailoot

GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content

Проверить статус задачи

GET статус исходной операции

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Чтение другого содержимого

Сохраняйте каждый готовый результат, принадлежащий вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

Сохраняйте все готовые результаты

Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.

Сохраняйте каждый фактический результат, принадлежащий Ailoot, и возвращённые измеренные метаданные.

Если нужно проверить исходный ответ

503 result_pending_check + исходный id + X-Should-Retry:false; никогда не отправляйте исходный запрос повторно

Поля ответа

Поле	Тип	Значение
Поле`index`	Типinteger	ЗначениеПозиция этого видео в списке результатов, начиная с нуля.
Поле`content_url`	Типstring	ЗначениеПодписанный HTTPS URL для скачивания этого готового видео.
Поле`sha256`	Типstring \| null	ЗначениеХэш SHA-256 исходных байтов видео; null, если недоступен.
Поле`size_bytes`	Типinteger \| null	ЗначениеРазмер исходного видеофайла в байтах; null, если недоступен.
Поле`duration_ms`	Типinteger \| null	ЗначениеИзмеренная длительность видео в миллисекундах; null, если недоступна.
Поле`width`	Типinteger \| null	ЗначениеШирина видео в пикселях; null, если недоступна.
Поле`height`	Типinteger \| null	ЗначениеВысота видео в пикселях; null, если недоступна.
Поле`video_codec`	Типstring \| null	ЗначениеИдентификатор видеокодека; null, если не записан.
Поле`has_audio`	Типboolean \| null	ЗначениеЕсть ли у видео аудиодорожка; null, если не измерено.
Поле`audio_codec`	Типstring \| null	ЗначениеИдентификатор аудиокодека; null, если идентификатор не записан.

Ошибки и дальнейшие шаги

Ответ	Условие	Следующий шаг
Ответ404 · `not_found_error`	УсловиеДоступ к видео недоступен либо этот ID видео не найден.	Следующий шагПроверьте доступ к видео. Для существующего видео используйте исходный публичный ID и тот же ключ API.
Ответ401 · `authentication_error`	УсловиеКлюч API не соответствует авторизованному аккаунту.	Следующий шагПеред отправкой проверьте ключ API и доступ к аккаунту.
Ответ400 · `invalid_request_error`	УсловиеНе удалось прочитать запрос либо индекс скачивания недопустим.	Следующий шагИсправьте тело запроса. Для скачивания выберите индекс результата, возвращённый исходной задачей.
Ответ422 · `price_unavailable`	УсловиеНевозможно определить цену выбранной конфигурации видео.	Следующий шагВыберите поддерживаемую конфигурацию видео и заполните обязательные параметры перед отправкой исправленного запроса.
Ответ422 · `invalid_request_error`	УсловиеНедопустимы входное видео или исходная задача продолжения.	Следующий шагИспользуйте корректные входные HTTPS-ссылки. Для продолжения используйте исходный публичный ID вашего готового видео и тот же ключ API.
Ответ402 · `billing_error`	УсловиеДоступный баланс или лимиты не позволяют зарезервировать средства.	Следующий шагПеред отправкой нового запроса проверьте доступный баланс и лимиты.
Ответ503 · `server_error`	УсловиеПроверка видео, хранилище или доступ к сервису временно недоступны.	Следующий шагДождитесь доступности сервиса. Если у вас уже есть ID видео, проверяйте ту исходную задачу вместо создания новой генерации.
Ответ503 · `result_pending_check`	УсловиеНужно проверить результат исходного видео и начисление.	Следующий шагСохраните возвращённый ID видео и проверьте эту задачу. Не отправляйте заменяющий запрос на генерацию, пока идёт проверка.
Ответ503 · `owned_result_unavailable`	УсловиеСкачивание существующего видео временно недоступно.	Следующий шагПроверьте ту же видеозадачу позже и скачайте её существующий результат. Новая генерация создаёт отдельную операцию.
Ответ409 · `video_not_ready`	УсловиеСодержимое видео не опубликовано.	Следующий шагПроверьте исходный статус задачи. Скачайте результат после completed; при failed следуйте уведомлению о проверке начисления.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra kwaivgi/kling-v3.0-pro

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

kwaivgi/kling-v3.0-pro

FAQ · Kling: Video v3.0 Pro

Какие входные данные и результаты доступны?: POST /v1/videos · kwaivgi/kling-v3.0-pro: text, image → video
Какие поля использует запрос?: POST /v1/videos · kwaivgi/kling-v3.0-pro: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user
Какие ограничения действуют?: POST /v1/videos · kwaivgi/kling-v3.0-pro: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

Kling: Video v3.0 Pro