Непрерывность длинного ИИ-видео: советы и рабочие процессы для Kling Video O1
Целевая модель:
kling-video-o1
Эндпоинт инференса:https://api.toapis.com/v1/videos/generations
Связанные материалы: Руководство по мультишотам Kling 3.0 Omni · Руководство по автоматизации Kling 3.0 Turbo · Быстрый старт Wan 3.0 Video API · Wan 3.0 Prime против Wan 2.6 Flash · Справка kling-video-o1 · Model guide kling-video-o1
1. Кратко и обзор возможностей
- Сначала каталог: в черновиках планирования иногда пишут
kling-3-omni. Эта строка не является документированным публичным ID Kling Video O1 и не заменяетkling-v3-omni. Проверка 2026-11-20 официальной справки генерации O1 и страницы model-guide (HTTP 200) показывает фиксированное значениеmodelkling-video-o1. - Одно задание — не полнометражный ролик: документированные значения
duration— целые числа 3–10 секунд (по умолчанию5). Утверждения черновиков об авторегрессивном буфере памяти,previous_task_id,tail_frame_url, «последних 8 кадрах» или «6 проходах = 30 с» не появляются в публичном контракте. Более длинные произведения собирайте из документированных запросов и склеивайте файлы самостоятельно. - Непрерывность — это задача ссылок: используйте официальные плейсхолдеры
<<<image_N>>>,<<<video_N>>>и<<<element_N>>>вместе сmetadata.image_list,video_listиmetadata.element_list. Порядок списков должен совпадать с порядком плейсхолдеров; система не вставляет плейсхолдеры автоматически и не добавляет первый кадр сама. - Контракт: асинхронно отправляйте на
POST /v1/videos/generations, затем опрашивайтеGET /v1/videos/generations/{id}доcompletedилиfailed. Обычные задачи можно также запрашивать черезGET /v1/tasks/{id}. Официальные примеры используютhttps://toapis.com(для материкового Китая —https://toapis.cn). Другие руководства этой серии используютhttps://api.toapis.com. Выберите один origin и придерживайтесь его. - Непроверенные утверждения, которые нужно отбросить: черновые цены вроде
$0.030/sили$0.038/s, а также цифры SLA и задержки не являются текущей документацией ToAPIs. Подтверждайте живые ставки в каталоге аккаунта.
2. Официальный ID O1 и документированные инструменты непрерывности
В поле model используйте публичное имя модели. Не подставляйте черновой псевдоним, slug URL или связанный, но другой ID каталога.
| ID каталога | Роль в этом руководстве | Документированные задачи |
|---|---|---|
kling-video-o1 | Основной ID статьи | Текст в видео и официальные ссылки Omni: image_list, video_list и element_list |
kling-v3-omni | Связанный ID Omni; см. руководство по мультишотам дня 17 | Отдельный документированный контракт Omni — похожий стиль плейсхолдеров, другая строка модели и другое окно длительности |
kling-3.0-turbo | Сестринский ID короткого формата; см. руководство Turbo | Только текст в видео и изображение в видео по первому кадру — не контракт ссылок Omni |
Основные поля запроса kling-video-o1:
| Поле | Документированные значения | Примечания |
|---|---|---|
prompt | Обязательная строка | Ссылайтесь на активы плейсхолдерами с нумерацией с 1 |
mode | std (по умолчанию) или pro | std соответствует 720P; pro — 1080P; тот же флаг задаёт разрешение тарификации |
duration | Целые 3–10 (по умолчанию 5) | Уже, чем у kling-v3-omni (3–15). Предпочитайте эту справку генерации более короткому превью площадки |
aspect_ratio | Обычные значения 16:9 (по умолчанию), 9:16, 1:1 | Как на официальной странице |
audio | Булево, по умолчанию false | true тарифицируется как Sound; несовместимо с video_list |
video_list | Не более одного клипа (китайская справка) | Тарифицируется как Video. refer_type: base (редактирование источника) или feature (движение или признак). keep_original_sound: yes или no |
metadata.image_list | Публичные значения image_url | Необязательный type: first_frame или end_frame; end_frame требует first_frame |
metadata.element_list | Активы субъекта или роли | url плюс необязательные type (например image или video) и role |
watermark | Булево | Только вкл./выкл. |
client_business_id | Необязательная строка | В китайской справке O1 документировано как поле верхнего уровня (также принимается в metadata, предпочтителен верхний уровень). Затем можно запросить GET /v1/videos/generations/{client_business_id} |
Синтаксис плейсхолдеров начинается с 1 и должен совпадать с порядком списков:
| Синтаксис | Ссылается на |
|---|---|
<<<image_1>>> | Первый элемент metadata.image_list |
<<<video_1>>> | Первый (и, по китайской справке, единственный) элемент video_list |
<<<element_1>>> | Первый элемент metadata.element_list |
Английская страница генерации иллюстрирует синтаксис списка через <<<video_2>>>. Китайская справка ограничивает video_list одним клипом и добавляет правила к медиа: публичный MP4 или MOV, длительность не менее 3 секунд, разрешение 720px–2160px, частота 24–60 кадр/с, размер не более 200 МБ. Не отправляйте второй опорный ролик, пока справка вашего аккаунта не скажет иное.
Практический длинный процесс, который остаётся внутри этого контракта:
- Раскадровка по тактам 3–10 секунд. Пишите один промпт на такт. Зафиксируйте открывающий и закрывающий кадры через
type: "first_frame"иtype: "end_frame"и упомяните оба в промпте (Transition from <<<image_1>>> to <<<image_2>>>). - Закрепите идентичность через
element_list. Повторно используйте один и тот же URL субъекта и стабильныйrole(например"subject") в связанных заданиях, чтобы одежда, лицо и пропорции не «уплывали» при смене описания камеры. - Заимствуйте движение через
refer_type: "feature"или редактируйте предыдущий дубль черезrefer_type: "base". Направьте<<<video_1>>>на публичный референс движения и попросите<<<element_1>>>следовать ему. Используйтеbase, когда редактируете сам исходный клип. Приrefer_typeравномbaseкитайская справка запрещает первый и конечный кадры, ожидает источник 3–10 секунд и указывает, что длительность выхода следует за загруженным видео. Не ставьте одновременноaudio=true. - Связывайте задания явно, затем склеивайте. Документ статуса — не специализированный API последнего кадра O1 и не «продолжить эту задачу». После
completedскачайтеresult.data[0].url(и используйтеlast_frame_urlв ответе статуса, если оно есть), разместите публичный кадр или клип и передайте его как следующийfirst_frameилиvideo_url. Склеивайте файлы в своём редакторе или конвейере ffmpeg. Сохраняйте каждый идентификатор задачи и версию шаблона промпта.

Рисунок 1: каждое документированное задание O1 возвращает один сегмент. Разместите публичный кадр или клип из завершённого результата, отправьте его в следующем запросе как первый кадр или опорное видео, затем склеивайте файлы самостоятельно.
Если нужны списки в стиле Omni на модели дня 17, используйте kling-v3-omni (длительность 3–15 секунд). Для массовых коротких черновиков без списков Omni используйте kling-3.0-turbo. Для более длинного окна одного запроса в другом семействе см. быстрый старт Wan 3.0 (документировано 2–30 секунд или -1 для умной длительности).
3. Производственная реализация: cURL и Python
Международные примеры этой серии используют https://api.toapis.com. Официальная документация указывает пользователям материкового Китая https://toapis.cn. Оставляйте один origin на среду. Пути, ID моделей и заголовок Bearer остаются теми же.
Шаг 1. Отправка такта с первым и конечным кадрами через cURL
curl --request POST \
--url https://api.toapis.com/v1/videos/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-video-o1",
"prompt": "Transition from <<<image_1>>> to <<<image_2>>>, keeping the same subject, lighting, and camera height as the streets empty at dusk",
"mode": "std",
"duration": 8,
"aspect_ratio": "16:9",
"client_business_id": "o1-episode-01-beat-03",
"metadata": {
"image_list": [
{"image_url": "https://example.com/beat-03-start.jpg", "type": "first_frame"},
{"image_url": "https://example.com/beat-03-end.jpg", "type": "end_frame"}
],
"element_list": [
{"url": "https://example.com/character.jpg", "type": "image", "role": "subject"}
]
}
}'
Если список субъекта должен участвовать в генерации, в промпте также укажите <<<element_1>>>. Сохраните возвращённый id (или свой client_business_id) до опроса.
Шаг 2. Помощник и опросчик на Python
Фрагмент следует документированному пути статуса задачи и состояниям queued / in_progress / completed / failed. Перед выпуском сверьте id, result.data[0].url и конверт ответа со справкой API для вашего аккаунта.
import os
import time
import requests
API_KEY = os.environ["TOAPIS_API_KEY"]
BASE = "https://api.toapis.com"
ENDPOINT = f"{BASE}/v1/videos/generations"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
DOCUMENTED_ID = "kling-video-o1"
DURATION_RANGE = range(3, 11)
def dispatch_o1(
prompt: str,
*,
model: str = DOCUMENTED_ID,
mode: str = "std",
duration: int = 5,
aspect_ratio: str = "16:9",
audio: bool = False,
image_list: list[dict] | None = None,
element_list: list[dict] | None = None,
video_list: list[dict] | None = None,
client_business_id: str | None = None,
) -> str:
if model != DOCUMENTED_ID:
raise ValueError("Send kling-video-o1; kling-3-omni and kling-v3-omni are not this model's public ID")
if mode not in {"std", "pro"}:
raise ValueError("mode must be std or pro")
if duration not in DURATION_RANGE:
raise ValueError("duration must be an integer from 3 to 10")
if audio and video_list:
raise ValueError("audio and video_list are mutually exclusive")
if video_list and len(video_list) > 1:
raise ValueError("video_list is documented as at most one clip")
types = [item.get("type") for item in (image_list or [])]
if "end_frame" in types and "first_frame" not in types:
raise ValueError("end_frame requires first_frame")
if video_list:
refer = video_list[0].get("refer_type", "base")
if refer == "base" and ("first_frame" in types or "end_frame" in types):
raise ValueError("refer_type=base cannot be combined with first_frame or end_frame")
payload = {
"model": model,
"prompt": prompt,
"mode": mode,
"duration": duration,
"aspect_ratio": aspect_ratio,
}
if audio:
payload["audio"] = True
if video_list:
payload["video_list"] = video_list
metadata = {}
if image_list:
metadata["image_list"] = image_list
if element_list:
metadata["element_list"] = element_list
if metadata:
payload["metadata"] = metadata
if client_business_id:
payload["client_business_id"] = client_business_id
res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
res.raise_for_status()
data = res.json()
task_id = data.get("id") or data.get("task_id")
if not task_id:
raise RuntimeError(f"Unexpected submission envelope: {data}")
return task_id
def poll_task(task_id: str, deadline_s: int = 600) -> str:
poll_url = f"{BASE}/v1/videos/generations/{task_id}"
interval = 10.0
start = time.time()
time.sleep(5)
while time.time() - start < deadline_s:
poll = requests.get(poll_url, headers=HEADERS, timeout=15)
if poll.status_code == 429:
retry_after = poll.headers.get("Retry-After")
time.sleep(float(retry_after) if retry_after else min(interval * 2, 120))
continue
poll.raise_for_status()
data = poll.json()
status = data.get("status")
if status == "completed":
return data["result"]["data"][0]["url"]
if status == "failed":
raise RuntimeError(f"Generation failed: {data.get('error')}")
time.sleep(interval)
interval = min(interval * 1.5, 30.0)
raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
if __name__ == "__main__":
task_id = dispatch_o1(
"Keep <<<element_1>>> in frame while the camera moves from <<<image_1>>> to <<<image_2>>>",
duration=8,
image_list=[
{"image_url": "https://example.com/beat-03-start.jpg", "type": "first_frame"},
{"image_url": "https://example.com/beat-03-end.jpg", "type": "end_frame"},
],
element_list=[
{"url": "https://example.com/character.jpg", "type": "image", "role": "subject"},
],
client_business_id="o1-episode-01-beat-03",
)
print("Task:", task_id)
print("Video:", poll_task(task_id))
После загрузки файла разместите закрывающий кадр (или сам клип, если следующий такт — правка base) по публичному URL и запустите следующий вызов dispatch_o1. Документированной серверной склейки нет, как нет и поля, которое указывало бы O1 на предыдущий task_id. Храните версию шаблона промпта рядом с записью задачи. Скачивайте файл до expires_at; справка о статусе документирует 30-дневное окно хранения.
4. Обработка ошибок и матрица статусов
Категории ниже — отправная точка диагностики, а не гарантия точных кодов ошибок ToAPIs. Успешный HTTP-запрос всё равно требует читать status задачи. См. справочник ошибок для ошибок запроса и причин status: failed, таких как content_policy_rejected, insufficient_user_balance или generation_timeout.
| HTTP или состояние задачи | Частая категория | Рекомендуемое действие |
|---|---|---|
400 | Недопустимое поле, расхождение плейсхолдера и списка, audio вместе с video_list, end_frame без first_frame или base вместе с первым/конечным кадром | Подтвердите kling-video-o1, совпадение порядка плейсхолдеров со списками, публичные URL и отсутствие взаимно исключающих полей |
401 | Отсутствующий или недействительный API-ключ | Смените ключ в панели ToAPIs и проверьте заголовок Authorization: Bearer |
429 | Ограничение частоты или параллелизма | Соблюдайте Retry-After, если он есть; отступайте с джиттером; повторяйте только когда это безопасно |
5xx или тайм-аут клиента | Временная проблема шлюза или апстрима | Запросите существующий идентификатор задачи (или client_business_id) до повторной отправки |
status: queued или in_progress | Это не ошибка | Подождите и опросите снова; не создавайте второй такт для того же слота |
status: failed | Генерация не удалась | Читайте error.code и error.message (и error.reason, если есть). Не повторяйте неизменённую нагрузку, отклонённую политикой |
5. Цены и FinOps
Официальная английская справка O1 публикует карту тарификации, а не долларовую таблицу. Используйте её, чтобы выбрать семейство SKU, затем читайте сумму, которую фактически котирует ваш аккаунт.
| Форма запроса | Спецификация тарификации |
|---|---|
mode=std, audio=false, без video_list | 720P (std) |
mode=pro, audio=false, без video_list | 1080P (pro) |
audio=true | Тарификация как Sound (и несовместимо с video_list) |
Запрос содержит video_list | Тарификация как Video |
Выгрузка страницы model-guide kling-video-o1 от 2026-11-20 показала ценовой ориентир 12 credits / секунду и указала, что итоговая тарификация следует текущей котировке аккаунта. Страница не публиковала долларовую ставку за секунду и не выделяла Sound или Video отдельными долларовыми или кредитными цифрами. Не переводите кредиты в валюту самостоятельно и не используйте черновые ставки вроде $0.030/s или $0.038/s.
- Сначала черновик в
std. Итерируйте на 720P и средней длительности, например 5 секунд, храните версионный пакет промпта и кадров и меняйте один список ссылок за раз, прежде чем повышатьmodeили длительность до 10 секунд. - Расход на длинный формат — сумма успешных сегментов плюс фактические повторные отправки неудачных попыток. Тайм-аут клиента не доказывает, что такт провалился: запросите id до дублирующей отправки.
- Отображаемая цена — не гарантия канала. Перед прогнозом эпизода подтвердите ID, SKU и доступность через
GET /v1/models?type=videoи живую котировку аккаунта.
6. Часто задаваемые вопросы
См. блок FAQ во frontmatter. Кратко: отправляйте kling-video-o1, а не kling-3-omni или kling-v3-omni; документированных previous_task_id и tail_frame_url нет; длительность — 3–10 секунд; audio и video_list нельзя сочетать; связывайте публичные кадры или клипы самостоятельно и сохраняйте каждый идентификатор задачи.
7. Контрольный список действий
- Создайте ключ на портале разработчика ToAPIs.
- Подтвердите, что
kling-video-o1виден для вашего ключа черезGET /v1/models?type=video— не отправляйтеkling-3-omni. - Прогоните фрагмент cURL с
image_listпервого и конечного кадра,mode: "std"иduration: 5. - Опрашивайте
GET /v1/videos/generations/{id}с ограниченным дедлайном, скачивайте результат доexpires_atи сами размещайте публичный кадр или клип следующего такта. - Далее: руководство по мультишотам Kling 3.0 Omni, если нужен Omni ID дня 17; model guide kling-video-o1 для живого статуса каталога; быстрый старт Wan 3.0, если один запрос должен длиться больше 10 секунд.







