ToAPIs
    ホームToAPIs
    画像生成GPT Image 2.6、Gemini、FLUX…動画生成Seedance、Veo、Kling、Sora…チャット・文章作成GPT-5.6、Claude、DeepSeek…音声・音楽ナレーション、音声合成、音楽
    新着Seedance 2.5
    料金API ドキュメントMCP
    ブログ代替製品
    ログイン無料で試す
    すべてのモデル料金API ドキュメントMCPブログ代替製品
    ログイン無料で試す

    言語

    Esc
    • Seedance 2.5動画生成
    • GPT Image 2画像生成
    • GPT Image 2.6画像生成
    • GPT Image 2.5画像生成
    • Veo 3.1 Fast動画生成
    • Kling 3.0 Turbo動画生成
    • Kling V4 Flash動画生成
    • Grok Video 1.5動画生成
    • Nano Banana 2画像生成
    • Seedream 5.5画像生成
    • FLUX画像生成
    • Sora 2動画生成
    • すべての画像モデルカテゴリ
    • すべての動画モデルカテゴリ
    • GPT-5.6 Solチャット・コーディング
    • Claude Opus 4.8チャット・コーディング
    • Claude Opus 4.7チャット・コーディング
    • DeepSeek V4 ProDeepSeek · テキスト
    • Gemini Omni 1.1 FlashGoogle · マルチモーダル
    1. ホーム
    2. ブログ
    3. チュートリアル
    4. Kling 3.0 Omni API 徹底解説:マルチショット動画生成と物理的な連続性
    すべての記事に戻る
    tutorial2026-11-1811 分で読める

    Kling 3.0 Omni API 徹底解説:マルチショット動画生成と物理的な連続性

    ToAPIs 上の kling-v3-omni 実践ガイド。公式 Omni プレースホルダ、image_list / video_list / element_list、先頭・末尾フレーム、文書化されたポーリング経路を扱い、未文書の shots 配列は使いません。

    ToAPIs Engineering & Evaluation Team
    Kling OmniVideo APIMulti-ShotText-to-VideoTutorial
    TL;DR - 要点まとめ
    • 文書化されている公開モデル ID は kling-v3-omni です。企画ドラフトの kling-3-omni は現行の API 契約ではありません。文書どおりの文字列だけを送ってください。
    • Bearer API キーで POST /v1/videos/generations に投入し、タスク id を永続化して GET /v1/videos/generations/{id} をポーリングします。通常タスクは GET /v1/tasks/{id} でも照会できます。/v1/videos/tasks やクエリ文字列の video-status URL を作らないでください。
    • 文書化された shots 配列はありません。マルチショットの連続性は、公式プレースホルダ <<<image_N>>>、<<<video_N>>>、<<<element_N>>> と metadata.image_list、metadata.element_list、video_list で組み立てます。
    • 画像と参照動画は公開 http(s) URL である必要があります。ローカルファイルは先に POST /v1/uploads/images でアップロードし、base64 は受け付けられません。audio と video_list は互排他です。
    • 企画ドラフトの未検証なドル単価や SLA は再利用しないでください。Omni の課金マップは std/pro に加え、基本、Sound、Video の SKU です。ライブ料金はアカウントカタログで確認してください。

    Kling 3.0 Omni API 徹底解説:マルチショット動画生成と物理的な連続性

    対象モデル: kling-v3-omni
    推論エンドポイント: https://api.toapis.com/v1/videos/generations
    関連: Kling 3.0 Turbo 自動化ガイド · Kling V4 Flash API ガイド · kling-v3-omni リファレンス · kling-v3-omni モデルガイド


    1. クイックスタートと性能概要 (TL;DR)

    • まずカタログを見る: 企画ドラフトはときどき kling-3-omni と書きます。その文字列は文書化された公開 ID ではありません。2026-11-18 に公式生成リファレンスと モデルガイドページ(HTTP 200)を確認した結果、固定の model 値は kling-v3-omni です。この正確な文字列を送ってください。
    • 契約: 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 つにそろえてください。
    • shots[] フィールドはない: マルチショットの連続性と物理的な一貫性は、プロンプトと参照素材の問題です。公式プレースホルダ <<<image_N>>>、<<<video_N>>>、<<<element_N>>> を、metadata.image_list、video_list、metadata.element_list と組み合わせて使います。リスト順はプレースホルダ順と一致させる必要があります。システムはプレースホルダを自動挿入せず、先頭フレームも自動追加しません。
    • メディア: 公開の http:// または https:// URL だけを送ってください。ローカルファイルは POST /v1/uploads/images でアップロードし、返却 URL を使います。base64 は送らないでください。audio と video_list は互排他です。
    • 捨てるべき未検証の主張: $0.022/s のようなドラフト単価、99.95% の SLA、カスタム shots スキーマは、現行の ToAPIs ドキュメントではありません。ライブ料金とチャネル可否はアカウントで確認してください。

    2. 公式 Omni ID、プレースホルダ、連続性ワークフロー

    model フィールドには公開モデル名を使います。ドラフトの別名、URL スラッグ、関連するが別のカタログ ID に置き換えないでください。

    カタログ ID本ガイドでの役割文書化されているジョブ
    kling-v3-omni本記事のヒーロー IDテキストから動画、および公式 Omni 参照:image_list、video_list、element_list
    kling-3.0-turbo姉妹のショートフォーム ID。Turbo ガイド を参照テキストから動画と先頭フレームの画像から動画のみ。Omni 参照契約ではない
    kling-v3関連する非 Omni の v3 ID別の生成リファレンスです。その文書がそう書いていない限り、Omni リストやプレースホルダをこの ID に送らないでください

    kling-v3-omni の主なリクエストフィールド:

    フィールド文書化されている値注記
    prompt必須の文字列1 始まりのプレースホルダで素材を参照する
    modestd(デフォルト)または prostd は 720P、pro は 1080P。同じフラグが課金解像度も決める
    duration整数 3–15(デフォルト 5)5 秒または 10 秒に限定されない
    aspect_ratio一般値 16:9(デフォルト)、9:16、1:1マーケ用のパラメータ表が短い場合は生成リファレンスを優先
    audioブール、デフォルト falsetrue は 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任意の文字列中国語 Omni リファレンスではトップレベル(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 本に制限しています。アカウントリファレンスが後から別途述べない限り、2 本目の参照動画は送らないでください。

    文書化されたフィールドだけで、マルチショットで物理的に一貫したクリップを組み立てる方法は残っています。

    1. 先頭と末尾フレームで弧を固定する。 開始静止画を image_list に type: "first_frame" で入れ、終了静止画を type: "end_frame" にします。プロンプトで両方に言及し(<<<image_1>>> から <<<image_2>>> へ遷移)、その間の動き、重力、カメラ経路を記述します。
    2. element_list で同一性を固定する。 関連ジョブで同じ被写体 URL と安定した role(例: "subject")を再利用し、カメラ記述だけを変えたときに衣服・顔・比率が流れないようにします。
    3. refer_type: "feature" で動きを借りる。 <<<video_1>>> を公開のモーション参照に向け、<<<element_1>>> にその動きを追わせます。ソースクリップ自体を編集する場合(背景置換など)は refer_type: "base" を使います。
    4. ジョブを明示的につなぐ。 ステータス文書は Omni 専用のラストフレーム API ではありません。後続ショットを前のテイクから始めたい場合は、そのテイクの公開スチルまたはダウンロードをホストし、次の first_frame として送ってください。各タスク id は永続化します。

    空の参照リストパネルが六角形のゲートウェイに合流し、1 枚の出力フレームになる様子

    図 1: 公開 URL のみの image_list、video_list、element_list を POST /v1/videos/generations に送り、同じタスク id をポーリングし、status が completed になってから result.data[0].url を読む。

    Omni リストが不要な高頻度ショートフォームの下書きには、kling-3.0-turbo を使います。別の Kling 生成契約については Kling V4 Flash ガイド を参照してください。


    3. 本番実装: cURL と Python

    本シリーズの国際例は https://api.toapis.com を使います。公式ドキュメントは中国本土の利用者に https://toapis.cn を案内しています。環境ごとにオリジンは 1 つに固定してください。パス、モデル ID、Bearer ヘッダは同じです。

    ステップ 1: 先頭・末尾フレームジョブの cURL 投入

    bash
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-v3-omni",
        "prompt": "Transition from <<<image_1>>> to <<<image_2>>>, keeping gravity, footsteps, and camera height consistent",
        "mode": "std",
        "duration": 5,
        "aspect_ratio": "16:9",
        "metadata": {
          "image_list": [
            {"image_url": "https://example.com/start.jpg", "type": "first_frame"},
            {"image_url": "https://example.com/end.jpg", "type": "end_frame"}
          ]
        }
      }'
    

    テキストのみのジョブでは metadata とプレースホルダを省略します。被写体とモーション参照のジョブでは refer_type: "feature" の video_list と metadata.element_list を使い、audio: true は設定しません。

    ステップ 2: Python ヘルパーとポーラー

    このスニペットは文書化されたタスク状態パスと、queued / in_progress / completed / failed に従います。出荷前に、アカウント向け API リファレンスで id、result.data[0].url、エンベロープを確認してください。

    python
    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-v3-omni"
    DURATION_RANGE = range(3, 16)
    
    
    def dispatch_omni(
        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-v3-omni; kling-3-omni is not a documented 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 15")
        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")
        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_omni(
            "Transition from <<<image_1>>> to <<<image_2>>>, keeping gravity, footsteps, and camera height consistent",
            image_list=[
                {"image_url": "https://example.com/start.jpg", "type": "first_frame"},
                {"image_url": "https://example.com/end.jpg", "type": "end_frame"},
            ],
        )
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    プロンプトテンプレートの版をタスク記録の横に保存し、プレースホルダやリスト順の変更と文言変更を区別できるようにします。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_framekling-v3-omni であること、プレースホルダ順が各リストと一致すること、メディアが公開 URL であること、互排他フィールドを併用していないことを確認する
    401API キー不足または無効ToAPIs ダッシュボードでキーをローテーションし、Authorization: Bearer ヘッダを確認する
    429レートまたは同時実行の制限Retry-After があれば従い、ジッタ付きでバックオフし、安全なときだけ再試行する
    5xx またはクライアントタイムアウトゲートウェイまたは上流の一時的な問題再投入する前に既存のタスク id を照会する
    status: queued または in_progressエラーではない待って再ポーリングする。2 つ目のジョブを作らない
    status: failed生成が成功しなかったerror.code と error.message(あれば error.reason)を読む。未変更のポリシー拒否ペイロードを再試行しない

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. 料金と FinOps ROI

    公式の中国語 Omni リファレンスは課金マップを公開しています。まず SKU 系統を選び、アカウントが実際に提示する金額を読んでください。

    リクエストの形課金仕様
    mode=std、audio=false、video_list なし720P
    mode=pro、audio=false、video_list なし1080P
    mode=std、audio=true720P+Sound
    mode=pro、audio=true1080P+Sound
    mode=std、video_list あり720P+Video
    mode=pro、video_list あり1080P+Video

    2026-11-18 に取得した kling-v3-omni モデルガイド は、料金参考値として 12 クレジット / 秒 を示し、最終請求は現行のアカウント見積もりに従うと述べていました。このページは Omni のドル毎秒料金を掲載しておらず、Sound や Video を別のドル金額にも分けていません。クレジットを独自に通貨換算せず、企画ドラフトの $0.022/s のような単価も再利用しないでください。

    Estimated cost=successful billable seconds×current account rate for that mode and SKU\text{Estimated cost} = \text{successful billable seconds} \times \text{current account rate for that mode and SKU}Estimated cost=successful billable seconds×current account rate for that mode and SKU

    • まず文書化された安いモードで下書きする。 std(720P)と 5 秒程度の中間 duration で反復し、版管理したプロンプトテンプレートを保ち、参照リストは一度に 1 つだけ変えます。
    • 表示価格はチャネル保証ではない。 ショットリストを見積もる前に、GET /v1/models?type=video とアカウントのライブ見積もりで ID、SKU、可用性を確認してください。
    • プロンプト層で支出を抑える: クライアントがタイムアウトしても、状態を確認するまで再投入しないでください。公式ベンダー契約はコミットや前払い下限を付けることが多く、ToAPIs の課金は通常従量制です。有効な条件はアカウントで確認してください。

    6. よくある質問

    frontmatter の FAQ を参照してください。要約: kling-v3-omni を送り、kling-3-omni は送らない。文書化された shots[] はない。duration は 3–15 秒で、mode が 720P または 1080P を選ぶ。audio と video_list は併用できない。generations のステータスパスをポーリングし、タスク id を永続化する。


    7. アクションチェックリスト

    • ToAPIs Developer Portal でキーを作成する。
    • GET /v1/models?type=video でキーに kling-v3-omni が見えることを確認する。kling-3-omni は送らない。
    • 先頭・末尾フレームの image_list、mode: "std"、duration: 5 で上記 cURL をスモークテストする。
    • 上限付きの期限で GET /v1/videos/generations/{id} をポーリングし、expires_at の前に結果をダウンロードする。
    • 次のステップ: 高頻度ショートフォームの下書きは Kling 3.0 Turbo 自動化ガイド、ライブカタログは kling-v3-omni モデルガイド、別の Kling 契約は Kling V4 Flash ガイド。

    記事内で紹介されたモデルとAPI

    KuaishouVIDEO

    kling-v3-omni

    現在のレート:12 credits /second
    モデル解説オンライン試用APIキーを取得
    KuaishouVIDEO

    Kling V3 Turbo

    現在のレート:16 credits /second
    モデル解説オンライン試用APIキーを取得
    KuaishouVIDEO

    kling-v3

    現在のレート:12 credits /second
    モデル解説オンライン試用APIキーを取得

    関連記事

    tutorial2026-11-18T10:00:00+08:0010 分で読める

    Kling 3.0 Turbo API:大量ショート動画オートメーションの設計

    ToAPIs 上の kling-3.0-turbo 本番ガイド。文書化された duration と解像度、先頭フレームのみの画像入力、上限付きポーリング、未検証ドラフト単価を使わない高頻度ショート動画の自動化。

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Turbo
    tutorial2026-11-20T10:00:00+08:0011 分で読める

    Alibaba Wan 3.0 Video API:次世代動画生成の始め方

    ToAPIs 上の wan3.0-video と wan3.0-video-prime の本番クイックスタート。1 つの All-in-One エンドポイント、先頭・末尾フレームと参照メディアの排他、ファイルまたはリンク参照、動画編集の制約、文書化されたポーリング経路を扱います。

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    tutorial2026-11-17T10:00:00+08:009 分で読める

    Grok-Video-3 API 実践ガイド:xAI ビデオエンジンで先に確認すべき現在の契約

    ToAPIs で xAI Grok Video を呼ぶ実践ガイド。公開カタログに載っているのは grok-video-1.0 と grok-video-1.5 であり grok-video-3 ではないこと、現行の generations 契約、モード、ポーリング経路を整理します。

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    ToAPIs
    ホームToAPIs
    エンタープライズ向け AI API ゲートウェイ。GPT-5、Claude、Gemini など 200 以上のモデルに 1 つの API でアクセスできます。

    人気モデル

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    もっと見る折りたたむ
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • すべてのモデル

    API カテゴリ

    • AI 画像生成 API
    • AI 動画生成 API
    • テキストから動画 API
    • 画像から動画 API
    もっと見る折りたたむ
    • AI 画像編集 API
    • 言語・推論モデル API
    • すべての API ツール →

    代替サービス

    代替サービス
    • Kie.ai の代替
    • Fal.ai 代替
    • OpenRouter の代替
    • Replicate 代替
    • Wavespeed AI 代替
    • すべてのサービス比較 →

    おすすめガイド

    おすすめガイド
    • Seedance 2.0 と 2.5 の料金比較
    • 低コスト Seedance API ガイド
    • MiniMax H3 連携ガイド
    • Seedance 2 無料テストキー
    • Seedance 2 API クイックスタート
    • すべての技術記事 →

    開発者・プラットフォーム

    開発者・プラットフォーム
    • API ドキュメント
    • MCP
    • 料金
    • モデルプレイグラウンド
    • LLMs.txt
    • サポートへ連絡
    • モデルガイド一覧
    運営主体:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    登記住所:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    プライバシー利用規約利用ポリシーデータ削除ポリシーデータ保持ポリシー委託先とデータリージョン請求と返金Cookie ポリシーサイトマップ概要

    © 2026 ToAPIs. All rights reserved.