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 Turbo API:大量ショート動画オートメーションの設計
    すべての記事に戻る
    tutorial2026-11-1810 分で読める

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

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

    ToAPIs Engineering & Evaluation Team
    Kling TurboVideo APIShort-FormAutomationTutorial
    TL;DR - 要点まとめ
    • 文書化されている公開モデル ID は kling-3.0-turbo です。企画ドラフトの kling-3-turbo は現行の API 契約ではありません。文書どおりの文字列だけを送ってください。
    • Bearer API キーで POST /v1/videos/generations に投入し、タスク id を永続化して GET /v1/videos/generations/{id} をポーリングします。通常タスクは GET /v1/tasks/{id} でも照会できます。
    • duration は 3〜15 秒の任意の整数(デフォルト 5)で、5 秒と 10 秒だけではありません。resolution は 720p または 1080p(デフォルト 720p)です。aspect_ratio はテキストから動画にだけ適用されます。
    • reference_images は先頭フレームのみです。最初の公開 URL が first_frame として使われます。末尾フレームはサポートされず、追加画像は無視されます。
    • 2026-11-18 のモデルガイドは 720p で $0.08/秒、1080p で $0.1/秒の表示料金を掲載し、料金は変わる可能性があり最終請求はアカウント見積もりに従うと注記していました。未検証のドラフト数値や自作 SLA は使わないでください。

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

    対象モデル: kling-3.0-turbo
    推論エンドポイント: https://api.toapis.com/v1/videos/generations
    関連: Kling 3.0 Omni 徹底解説 · Kling V4 Flash API ガイド · kling-3.0-turbo リファレンス · kling-3.0-turbo モデルガイド


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

    • まずカタログを見る: 企画ドラフトはときどき kling-3-turbo と書きます。その文字列は文書化された公開 ID ではありません。2026-11-18 に公式生成リファレンスと モデルガイドページ(HTTP 200)を確認した結果、固定の model 値は kling-3.0-turbo です。この正確な文字列を送ってください。
    • 契約: 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 つにそろえてください。
    • 文書化されている範囲: duration は 3〜15 秒の任意の整数(デフォルト 5)で、5 秒と 10 秒だけではありません。resolution は 720p または 1080p(デフォルト 720p)です。aspect_ratio(16:9、9:16、1:1)はテキストから動画のリクエストにだけ適用されます。
    • 画像入力は先頭フレームのみです。 reference_images を送る場合、最初の公開 URL だけが first_frame として使われます。この統合では末尾フレームはサポートされず、追加画像は無視されます。base64 は送らないでください。
    • 捨てるべき未検証の主張: 5 秒クリップあたり $0.11、「20 秒未満」のレイテンシ、「30+ 同時実行」、99.95% の SLA、「60% 安い」といったドラフト数字は、現行の API ドキュメントではありません。ライブのカタログまたはモデルガイドの数字だけを引用し、それらは変わり得る表示料金として扱ってください。

    2. 公式 Turbo ID と大量処理の制約

    model フィールドには公開モデル名を使います。ドラフトの別名、マーケ用の表示名、関連する Omni ID に置き換えないでください。

    カタログ ID本ガイドでの役割文書化されているジョブ
    kling-3.0-turbo本記事のヒーロー IDテキストから動画、および先頭フレーム入力のみの画像から動画
    kling-v3-omni姉妹の Omni ID。Omni ガイド を参照公式の image_list / video_list / element_list 参照(先頭・末尾フレームを含む)
    kling-v3関連する非 Omni の v3 ID別の生成リファレンスです。Turbo のフィールドがそのまま使えると思わないでください

    公式の Turbo 生成ページは、一部のマーケ文言より狭いです。モデルガイドの一般的な説明は追加の動画ワークフローに触れることがありますが、この ID の API リファレンスが文書化しているのはテキストから動画と先頭フレームの画像から動画だけです。自動化はパンフレットではなくリファレンスに合わせてください。

    フィールド文書化されている値注記
    prompt必須の文字列画像から動画では Turbo の prompt 内容として送られる
    reference_images任意の文字列配列先頭の画像だけが first_frame として使われ、以降は無視される
    resolution720p(デフォルト)、1080pOmni の mode=std/pro フラグではない
    duration整数 3–15(デフォルト 5)5 秒と 10 秒だけを列挙するドラフトは不完全
    aspect_ratio16:9(デフォルト)、9:16、1:1テキストから動画にのみ適用
    watermarkブール、デフォルト false公式 Kling 透かしのオン / オフのみ。カスタム透かしオブジェクトは不可

    高頻度ショートフォームの自動化は、この契約の上に載るオーケストレーションの問題です。

    1. 1 クリップ、1 タスク。 各バリアントを個別の非同期ジョブとして投入します。ポーリングを始める前に、タスク id(と自分側のリクエスト id)を永続化します。
    2. 待機には必ず上限を付ける。 期限、5〜10 秒以上のジッタ付き間隔、429 時の Retry-After を使います。ステータスリファレンスは長い動画に数分かかることがあると注記しています。同じ id を再照会するまで、クライアントのタイムアウトを失敗と見なさないでください。
    3. 同時実行 SLA を自作しない。 公式ドキュメントは、このモデルに予約された「30+ 同時実行」枠を公開していません。429 と 非同期タスクのレート制限 を見てください。バッチ状態照会は最大 100 件のタスク ID までです。
    4. 画像ジョブを正直に保つ。 カットに末尾フレーム、Omni リスト、またはモーション参照動画が必要なら、reference_images に意味を背負わせず kling-v3-omni に切り替えてください。

    短いリクエストカードのキューが六角形のゲートウェイを通り、出力フレームのバッチになる様子

    図 1: 各ショートフォームのバリアントを POST /v1/videos/generations に投入し、上限付きループで同じタスク id をポーリングし、status が completed になってから result.data[0].url を読む。


    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-3.0-turbo",
        "prompt": "A 5-second product teaser for a lightweight running shoe, street-level camera, clean daylight",
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9",
        "watermark": false
      }'
    

    画像から動画のジョブでは "reference_images": ["https://example.com/first-frame.png"] を追加し、aspect_ratio や 2 枚目の画像を末尾フレームとして頼らないでください。

    ステップ 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-3.0-turbo"
    DURATION_RANGE = range(3, 16)
    
    
    def dispatch_turbo(
        prompt: str,
        *,
        model: str = DOCUMENTED_ID,
        resolution: str = "720p",
        duration: int = 5,
        aspect_ratio: str = "16:9",
        reference_images: list[str] | None = None,
        watermark: bool = False,
    ) -> str:
        if model != DOCUMENTED_ID:
            raise ValueError("Send kling-3.0-turbo; kling-3-turbo is not a documented public ID")
        if resolution not in {"720p", "1080p"}:
            raise ValueError("resolution must be 720p or 1080p")
        if duration not in DURATION_RANGE:
            raise ValueError("duration must be an integer from 3 to 15")
        payload = {
            "model": model,
            "prompt": prompt,
            "resolution": resolution,
            "duration": duration,
            "watermark": watermark,
        }
        if reference_images:
            payload["reference_images"] = reference_images[:1]
        else:
            payload["aspect_ratio"] = aspect_ratio
        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")
    
    
    def dispatch_batch(prompts: list[str], **kwargs) -> list[str]:
        """Submit every prompt first, then poll. A failed submit must not hide already-issued ids."""
        task_ids = []
        for prompt in prompts:
            task_ids.append(dispatch_turbo(prompt, **kwargs))
        return task_ids
    
    
    if __name__ == "__main__":
        variants = [
            "A 5-second product teaser for a lightweight running shoe, street-level camera, clean daylight",
            "The same shoe on a wet evening street, slower tracking shot, warm storefront light",
        ]
        ids = dispatch_batch(variants, resolution="720p", duration=5)
        for task_id in ids:
            print("Task:", task_id)
            print("Video:", poll_task(task_id))
    

    プロンプトテンプレートの版を各タスク記録の横に保存し、解像度や duration の変更と文言変更を区別できるようにします。各ファイルは expires_at の前にダウンロードしてください。ステータスリファレンスは 30 日の保持期間を文書化しています。


    4. エラー処理とステータスマトリクス

    下表は診断の出発点であり、ToAPIs の正確なエラーコードを保証するものではありません。HTTP 照会が成功しても、タスクの status を読む必要があります。リクエストエラーと status: failed の理由(content_policy_rejected、insufficient_user_balance、generation_timeout など)は エラーリファレンス を見てください。

    HTTP またはタスク状態よくある分類推奨アクション
    400無効なフィールド、未対応の duration や resolution、この統合が受け付けないメディア種別kling-3.0-turbo であること、duration が 3–15、resolution が 720p または 1080p、画像があれば公開 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

    2026-11-18 に取得した kling-3.0-turbo モデルガイド は、次の表示比較料金を示し、料金は変わる可能性があり、最終請求は現行のアカウント料金、duration、resolution、アスペクト比、送信パラメータに従うと注記していました。

    仕様ToAPIs 表示料金(2026-11-18)同じページの公式表示料金
    720p$0.08 / 秒$0.1143 / 秒
    1080p$0.1 / 秒$0.1429 / 秒

    リポジトリ内のモデルガイド設定も同じ ToAPIs 表示額と、720p で 16 クレジット/秒、1080p で 20 クレジット/秒の行を載せています。これらはスナップショットであり、契約ではありません。「1000 本で $380」といったドラフト計算は再利用しないでください。

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

    • まず 720p で下書きする。 duration は控えめに保ち(文書上のデフォルトは 5 秒)、プロンプトテンプレートを版管理し、一度に 1 変数だけ変えます。
    • 表示価格はチャネル保証ではない。 バッチを見積もる前に、GET /v1/models?type=video とアカウントのライブ見積もりで ID と可用性を確認してください。
    • オーケストレーション層で支出を抑える: すべてのタスク id を永続化し、クライアントがタイムアウトしても状態確認まで再投入せず、expires_at の前に結果をダウンロードします。公式ベンダー契約はコミットや前払い下限を付けることが多く、ToAPIs の課金は通常従量制です。有効な条件はアカウントで確認してください。

    6. よくある質問

    frontmatter の FAQ を参照してください。要約: kling-3.0-turbo を送り、kling-3-turbo は送らない。duration は 3–15 秒。画像入力は先頭フレームのみ。文書化された Turbo 音声や Omni リスト契約はない。generations のステータスパスをポーリングし、すべてのタスク id を永続化し、SLA を自作しない。


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

    • ToAPIs Developer Portal でキーを作成する。
    • GET /v1/models?type=video でキーに kling-3.0-turbo が見えることを確認する。kling-3-turbo は送らない。
    • resolution: "720p"、duration: 5、aspect_ratio: "16:9" で上記 cURL をスモークテストする。
    • 上限付きの期限で GET /v1/videos/generations/{id} をポーリングし、expires_at の前に結果をダウンロードする。
    • 次のステップ: 公式 Omni 参照や末尾フレームが必要なら Kling 3.0 Omni 徹底解説、ライブカタログは kling-3.0-turbo モデルガイド、別の Kling 契約は Kling V4 Flash ガイド。

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

    KuaishouVIDEO

    Kling V3 Turbo

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

    kling-v3-omni

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

    kling-v3

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

    関連記事

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

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

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

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Omni
    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
    insights2026-11-20T10:00:00+08:0012 分で読める

    長尺AI動画の連続性:Kling Video O1 のヒントとワークフロー

    ToAPIs 上の Kling Video O1 で、文書化されたフィールドだけを使ってより長いシーケンスを組む方法。kling-video-o1、先頭・末尾フレーム、element_list、単一の video_list、クライアント側の結合であり、ドラフト別名や未文書の継続 ID は使いません。

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Video O1
    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.