Kling 2.5 Turbo API の使い方：5 分で最初の動画を生成

TL;DR

• Kling 2.5 Turbo は快手可霊の高速版動画モデルです。HiAPI にはテキストから動画と画像から動画の 2 つの入り口があり、モデルページを開くとオンラインで試せます。新規ユーザー登録で 200 クレジットが付与されます。
• どちらの入り口も 1 秒あたり $0.06：5 秒 $0.30、10 秒 $0.60。
• 呼び出し方：POST /v1/tasks で送信し、taskId を取得して結果を確認、完成動画は output[0].url にあります。

Kling 2.5 Turbo でできること

• 5 秒または 10 秒、約 1080p：解像度はアスペクト比に従い、16:9 なら 1920×1080 が出力されます。個別設定は不要です。
• テキストから動画は音声付き：どの動画にも音声トラックがあり、オン/オフの切り替えはありません。
• 画像から動画はエンドフレームに対応：スタートフレームで始まりを、エンドフレームで終わりを決め、モデルが中間の過程を補完します。
• 画像から動画は 6 種類のアスペクト比：横・縦・正方形に加え、4:3、3:4、21:9 のワイドスクリーンもあります。

Vertical cinematic shot of a ceramic artist in a sunlit studio. Her hands shape a small terracotta bowl on a spinning pottery wheel. The wet clay gradually rises as the wheel turns, a little water glints on the surface. The camera gently tracks upward from the bowl to her focused face. Warm morning light, linen apron, natural movement, one continuous shot, no text or logos.

このプロンプトで生成 →（10 秒、9:16 を選択）

kling-2.5-turbo/text-to-video、9:16、1080×1920、10 秒、音声トラック付き、$0.60。

2 つの入り口の選び方

モデル ID	入力	アスペクト比	音声	適した用途
kling-2.5-turbo/text-to-video	プロンプト	16:9、9:16、1:1	音声トラック付き	素材がなく、文字から始める
kling-2.5-turbo/image-to-video	スタートフレーム必須、エンドフレーム任意	6 種類；エンドフレーム追加時は 3 種類	音声トラックなし	商品画像、写真、イラストを動かす

2 つの入り口は同価格で、どちらも 1 秒あたり $0.06 です。

2 つの導入ルート

ブラウザで試す（3 ステップ）

1. テキストから動画または画像から動画のモデルページを開き、ログインします。
2. プロンプトを書きます。画像から動画の場合は先にスタートフレームをアップロードし、必要ならエンドフレームもアップロードします。
3. 5 秒とアスペクト比を選び、実行をクリックします。

API で呼び出す（3 ステップ）

1. コンソールの API Key ページでキーを作成し、環境変数 HIAPI_KEY に設定します。
2. POST https://api.hiapi.ai/v1/tasks で送信し、data.taskId が返ります。
3. GET /v1/tasks/{taskId} で status が success になるまで確認し、output[0].url をダウンロードします。

curl：最初の動画

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.5-turbo/text-to-video",
    "input": {
      "prompt": "Hands pour glossy caramel over a stack of pancakes, steam rises, camera slowly pushes in, warm kitchen light",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 秒、16:9、$0.30。画像から動画の場合は model を kling-2.5-turbo/image-to-video に置き換え、"image_urls": ["https://あなたの画像ホスト/frame.jpg"] を追加します。

Python：送信・ポーリング・ダウンロード

# pip install requests；先に export HIAPI_KEY=あなたの Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # 同じタスクを再試行するときは同じ Idempotency-Key を付け、二重課金を避ける
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# スタートフレーム + エンドフレーム：赤い車が左から右へ走り、青い車に変わる（5 秒、$0.30）
url = generate(
    "kling-2.5-turbo/image-to-video",
    prompt="A toy car moves smoothly from the left to the right and changes from red to blue. "
           "Keep the simple light grey background and beige ground. Continuous static camera shot.",
    image_urls=["https://あなたの画像ホスト/first.png", "https://あなたの画像ホスト/last.png"],
    duration=5, aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

スタートフレーム + エンドフレーム：狙った画面でカメラを止める

image_urls に 2 枚の画像を渡します：1 枚目がスタートフレーム、2 枚目がエンドフレームです。以下の例ではスタートフレームが左側の赤い車、エンドフレームが右側の青い車です：

スタートフレーム	エンドフレーム

A toy car moves smoothly from the left to the right and changes from red to blue. Keep the simple light grey background and beige ground. Continuous static camera shot.

このプロンプトで生成 →（スタートフレームとエンドフレームをアップロードし、5 秒、9:16 を選択）

kling-2.5-turbo/image-to-video、9:16、1080×1920、5 秒、スタートフレーム + エンドフレーム、$0.30。

車は右へ進みながら、途中で色が赤から紫、そして青へと変わり、最後にエンドフレームの位置で止まり、背景は最後まで変わりません。2 枚の画像は変えたい部分以外を同じにすると、結果が最も安定します。エンドフレームを追加した場合、アスペクト比は 16:9、9:16、1:1 のみ選択できます。

パラメータ表

フィールド	必須	値	説明
prompt	はい	1〜2500 文字	動作とカメラを書く；画像から動画では画面を説明する必要はない
duration	いいえ	5（デフォルト）/ 10	秒単位で課金
aspect_ratio	いいえ	テキスト：16:9（デフォルト）9:16 1:1；画像はさらに 4:3 3:4 21:9	エンドフレーム追加時は 16:9 9:16 1:1 のみ
image_urls	画像から動画では必須	1〜2 枚、jpeg/png/webp、1 枚あたり ≤10MB	1 枚目がスタートフレーム、2 枚目がエンドフレーム；テキストから動画ではこのフィールドを受け付けない
negative_prompt	いいえ	テキスト ≤2500、画像 ≤2496 文字	出したくない内容
cfg_scale	いいえ	0〜1、デフォルト 0.5	大きいほどプロンプトに忠実

resolution、seed、音声のオン/オフはありません。

遭遇するエラー

送信時にパラメータが不正な場合、API は直接 400 を返し、タスクは作成されず、料金も発生しません：

• duration: value must be one of 5, 10：長さは 5 と 10 のみです。
• aspect_ratio: value must be one of '16:9', '9:16', '1:1'：テキストから動画に他のアスペクト比を渡したか、画像から動画でエンドフレームを追加したのに 4:3、3:4、21:9 を選んでいます。
• image_urls: maxItems: got 3, want 2：最大 2 枚、スタートフレームとエンドフレームです。
• image_urls: missing required field "image_urls"：画像から動画でスタートフレームを渡していません。
• cfg_scale: maximum: got 5, want 1：cfg_scale は 0 から 1 で、他のモデルでよくある 1〜20 ではありません。
• additional properties 'seed', 'sound' not allowed：この 2 つのフィールドは存在しません。

本番前の注意点

• ポーリングの代わりにコールバックを使う：リクエストのトップレベル（input と同じ階層）に "callback": {"url": "https://あなたのドメイン/hiapi/callback"} を追加し、taskId で重複排除します。
• 速やかに転送保存する：output[0].url は約 7 日で失効するため、取得したら自分のストレージに保存します。
• duration と aspect_ratio を明示する：指定しないと 5 秒、16:9 になり、縦画面の要件を見落としがちです。
• 再試行には冪等キーを付ける：リクエストヘッダーに Idempotency-Key を追加し、同じキーではタスクを 1 回だけ作成します。

よくある質問

テキストから動画の音声はオフにできますか？

できません。音声のオン/オフはありません。音声が不要な場合は編集時に音声トラックを外すか、もともと音声トラックのない画像から動画を使います。

画像から動画でスタートフレームの比率とアスペクト比が違うとどうなりますか？

スタートフレームは選択したアスペクト比で中央裁ちされます。16:9 の画像で 9:16 を選ぶと、中央の縦長部分が保持されるため、被写体を中央に置くのが最も安定します。

4K は出力できますか？

できません。出力は約 1080p で、アスペクト比によって異なり、最も広いのは 21:9 の 2200×940 です。

Kling 3.0 Turbo との選び方は？

5 秒か 10 秒で十分、最低価格を求めるなら Kling 2.5 Turbo を選んでください。3〜15 秒を秒単位で選びたい、または 720p と 1080p を選びたい場合は、Kling 2.5 Turbo と 3.0 Turbo の比較をご覧ください。

価格の詳細はKling 2.5 Turbo API の価格、より多くのシーンはKling 2.5 Turbo プロンプト大全をご覧ください。まず効果を見たい場合は、上の陶芸プロンプトをコピーして、モデルページで最初の 1 本を生成してください。