長尺AI動画の連続性: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 リファレンス · kling-video-o1 モデルガイド
1. TL;DR と性能概要
- まずカタログを確認する: 企画ドラフトはときどき
kling-3-omniと書きます。これは Kling Video O1 の文書化された公開 ID ではなく、kling-v3-omniの代わりでもありません。2026-11-20 に公式 O1 生成リファレンス と モデルガイド(HTTP 200)を確認したところ、固定のmodel値はkling-video-o1でした。 - 1 ジョブは長編ではありません: 文書化されている
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を使います。オリジンは 1 つに揃えてください。 - 捨てるべき未検証の主張:
$0.030/sや$0.038/sといったドラフト単価、SLA やレイテンシ数値は、現行の ToAPIs 文書ではありません。アカウントカタログで現行レートを確認してください。
2. 公式 O1 ID と文書化された連続性ツール
model フィールドには公開モデル名を使います。ドラフト別名、URL スラッグ、関連するが別のカタログ ID に置き換えないでください。
| カタログ ID | 本ガイドでの役割 | 文書化されたジョブ |
|---|---|---|
kling-video-o1 | 本記事の主役 ID | テキストから動画、および公式 Omni 参照:image_list、video_list、element_list |
kling-v3-omni | 関連 Omni ID。Day 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)より狭い。短い Playground プレビューより、この生成リファレンスを優先 |
aspect_ratio | 一般値 16:9(デフォルト)、9:16、1:1 | 公式ページのとおり |
audio | ブール、デフォルト false | true は Sound 課金。video_list と両立しない |
video_list | 最大 1 本(中国語リファレンス) | 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 を 1 本に制限し、メディア規則を追加しています。公開 MP4 または MOV、最短 3 秒、解像度 720px〜2160px、フレームレート 24〜60 fps、サイズ上限 200 MB です。アカウントリファレンスが後から別の規定を出さない限り、2 本目の参照動画は送らないでください。
その契約の内側に収まる、実用的な長尺ワークフローは次のとおりです。
- 3〜10 秒のビートで絵コンテを切る。 ビートごとに 1 つのプロンプトを書きます。開始と終了の静止画を
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も同時に立てないでください。- ジョブを明示的に連鎖し、自分で結合する。 ステータス文書は O1 専用の末尾フレーム API でも「このタスクを続ける」API でもありません。
completedのあとresult.data[0].urlをダウンロードし(ステータスペイロードにlast_frame_urlがあればそれを使えます)、公開静止画またはクリップとしてホストし、次のfirst_frameまたはvideo_urlとして送ります。ファイルは自分の編集ソフトや ffmpeg パイプラインで連結します。各タスク id と版付きプロンプトテンプレートを保存してください。

図 1: 文書化された O1 ジョブは毎回 1 セグメントを返します。完了結果の静止画やクリップを公開ホストし、次のリクエストで先頭フレームまたは参照動画として送り、ファイルは自分で結合します。
Day 17 モデルで同様の Omni リストが必要なら 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 を指定しています。環境ごとにオリジンは 1 つに揃えます。パス、モデル 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 に従います。出荷前に、アカウント向け API リファレンスで id、result.data[0].url、エンベロープを確認してください。
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 を開始します。文書化されたサーバー側結合はなく、前の task_id を O1 に指し示すフィールドもありません。プロンプトテンプレートの版をタスク記録の横に保存してください。expires_at より前にダウンロードします。ステータスリファレンスは 30 日の保持期間を文書化しています。
4. エラー処理とステータス行列
下表は診断の出発点であり、ToAPIs のエラーコードと完全に一致することを保証しません。HTTP 照会が成功しても、タスク status を読む必要があります。リクエストエラーと status: failed の理由(content_policy_rejected、insufficient_user_balance、generation_timeout など)は エラーリファレンス を見てください。
| HTTP またはタスク状態 | よくある分類 | 推奨アクション |
|---|---|---|
400 | 不正フィールド、プレースホルダとリストの不一致、audio と video_list の併用、first_frame なしの end_frame、または base と先頭・末尾フレームの併用 | kling-video-o1、プレースホルダ順と各リストの一致、公開 URL、互排他フィールドの非併用を確認 |
401 | API キー欠落または無効 | ToAPIs ダッシュボードでキーをローテーションし、Authorization: Bearer ヘッダを確認 |
429 | レートまたは同時実行制限 | Retry-After があれば遵守。ジッタ付きバックオフ。安全なときだけ再試行 |
5xx またはクライアントタイムアウト | ゲートウェイまたは上流の一時障害 | 再送する前に既存のタスク id(または client_business_id)を照会 |
status: queued または in_progress | エラーではない | 待って再ポーリング。同じスロットに 2 つ目のビートを作らない |
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 課金 |
2026-11-20 取得の kling-video-o1 モデルガイド は、料金参考として 12 credits / 秒 を示し、最終課金は現行アカウント見積もりに従うと述べていました。USD 単価はなく、Sound や Video を別のドル/クレジット数字にも分けていません。クレジットを自分で通貨換算せず、$0.030/s や $0.038/s といった企画ドラフト単価も再利用しないでください。
- まず
stdで下書きする。 720P と中程度の尺(例: 5 秒)で反復し、版付きのプロンプトと静止画パッケージを保ち、参照リストは一度に 1 つだけ変えてから、modeや 10 秒への延長を検討します。 - 長尺の支出は成功セグメントの合計に、実際に再送した失敗リトライを加えたものです。クライアントタイムアウトはビート失敗の証明ではありません。重複送信の前に id を照会してください。
- 表示価格はチャネル保証ではありません。 エピソードを見積もる前に、
GET /v1/models?type=videoとアカウントの現行見積もりで ID、SKU、利用可否を確認してください。
6. よくある質問
frontmatter の FAQ を参照してください。要約: kling-video-o1 を送り、kling-3-omni や kling-v3-omni は送らない。文書化された previous_task_id や tail_frame_url はない。尺は 3〜10 秒。audio と video_list は併用できない。公開静止画やクリップは自分で連鎖し、すべてのタスク id を保存する。
7. アクションチェックリスト
- ToAPIs Developer Portal でキーを作成する。
-
GET /v1/models?type=videoでキーにkling-video-o1が見えることを確認する。kling-3-omniは送らない。 - 先頭・末尾フレームの
image_list、mode: "std"、duration: 5で cURL スニペットをスモークテストする。 - 期限付きで
GET /v1/videos/generations/{id}をポーリングし、expires_atより前に結果をダウンロードし、次ビートの公開静止画やクリップは自分でホストする。 - 次の一歩: Day 17 の Omni ID が必要なら Kling 3.0 Omni マルチショットガイド、現行カタログは kling-video-o1 モデルガイド、単発で 10 秒を超える必要がある場合は Wan 3.0 クイックスタート。







