Kling 3.0 API の使い方：テキスト・画像から動画生成する中国語チュートリアル

TL;DR

• Kling 3.0（可霊 3.0）は快手が提供する動画モデルで、HiAPI ではテキストから動画 kling-3.0/text-to-video と画像から動画 kling-3.0/image-to-video の2つのエンドポイントがあり、1本 3～15 秒、最大 4K、ネイティブサウンドを有効にできます。モデルページを開く とオンラインで生成でき、新規ユーザー登録で 200 クレジットが付与されます。
• 秒単位の課金：720p は毎秒 $0.10、サウンド有効で $0.143；1080p は $0.129、サウンド有効で $0.193；4K は $0.479。5 秒 720p ならわずか $0.50。
• API は2ステップ：POST /v1/tasks で送信し、taskId を取得して結果を確認。以下の curl と Python はコピーするだけで実行できます。

まずは効果を確認

テキストから動画：英語のプロンプト1つ、リクエスト1回。

A lone red fox sprints across a windswept snowy ridge at golden hour, powder snow kicking up behind each stride, then leaps over a frozen creek in a graceful arc. Cinematic, dramatic side lighting, ultra-detailed fur, shallow depth of field, smooth motion.

このプロンプトで生成 →（5 秒、16:9）

kling-3.0/text-to-video モデルページの例、5 秒。720p サウンドオフで $0.50、1080p サウンドオンで $0.965。

画像から動画：以下の灯台の画像を最初のフレームとして使用。

The waves surge and crash against the rocks, the lighthouse beam sweeps slowly across the stormy night sky, rain streaks through the wind. Smooth cinematic motion, synchronized ambient sound of waves and storm.

このプロンプトで生成 →（最初のフレーム画像をアップロード、5 秒）

kling-3.0/image-to-video モデルページの例、5 秒。720p サウンドオンで $0.715。

Kling 3.0、Omni、Turbo の選び方

HiAPI 上の Kling 3.0 には3つのラインがあり、モデル名が異なり、料金とパラメータも異なります：

モデル	エンドポイント	720p / 秒	1080p / 秒	4K / 秒	用途
Kling 3.0 kling-3.0/*	テキスト・画像（最初のフレームまたは最初と最後のフレーム）	$0.10、サウンド有効 $0.143	$0.129、サウンド有効 $0.193	$0.479	サウンド付き完成動画、マルチショット短編
Kling 3.0 Omni kling-3.0-omni/*	テキスト・画像・参照・動画リライト	$0.10、サウンド有効 $0.129	$0.129、サウンド有効 $0.1645	$0.479	人物/商品の固定、参照動画のカメラワークに合わせる
Kling 3.0 Turbo kling-3.0-turbo/*	テキスト・画像	$0.13	$0.16	—	サウンドなし、解像度のみで課金

テキスト・画像のみなら kling-3.0 を選択；参照画像で主体を固定したり、参照動画や既存動画のリライトなら Kling 3.0 Omni 中国語チュートリアルを参照。

2つの導入ルート

オンライン試用（コード不要）

1. Kling 3.0 テキストから動画 モデルページを開き、登録またはログイン。
2. プロンプトを貼り付け、長さ、解像度、アスペクト比を選択し、サウンドの有無を決定。
3. 生成をクリックし、完成後に直接ダウンロード。

API 呼び出し

1. コンソールで API Key を作成。
2. POST https://api.hiapi.ai/v1/tasks でタスクを送信し、taskId を返す。
3. GET /v1/tasks/{taskId} で状態を確認し、status が success のとき output[0].url から動画をダウンロード。

curl：最初の動画

5 秒 720p サウンドオフ、$0.50：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0/text-to-video",
    "input": {
      "prompt": "金色夕阳下，一只红狐在风雪覆盖的山脊上疾奔，雪粉飞扬，电影级侧光，平滑跟拍",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "sound": false
    }
  }'

返り値：

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

結果の確認：

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

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

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(model, timeout_s=900, **params):
    body = {"model": model, "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{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)

# 竖屏、带声音的口播短视频
url = generate(
    "kling-3.0/text-to-video",
    prompt="竖屏短视频：一位博主拿着新耳机对着镜头介绍，手势自然，室内自然光，口型和说话声同步",
    duration=6, resolution="1080p", aspect_ratio="9:16", sound=True,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

この 6 秒 1080p サウンドオンで $1.158。

画像から動画：1枚の最初のフレーム、または最初と最後の2フレーム

モデル名を kling-3.0/image-to-video に変更し、画像を image_urls に入れます：1 枚は最初のフレーム、2 枚は [最初のフレーム, 最後のフレーム]。

{
  "model": "kling-3.0/image-to-video",
  "input": {
    "image_urls": [
      "https://your-cdn.example.com/start.jpg",
      "https://your-cdn.example.com/end.jpg"
    ],
    "prompt": "镜头缓慢推进，两个画面之间平滑过渡",
    "duration": 5,
    "resolution": "720p",
    "sound": false
  }
}

• 画像は JPEG / PNG / WebP に対応、SVG は非対応。
• 画像から動画には aspect_ratio はなく、アスペクト比は最初のフレームに従います。
• プロンプトはオプションで、「次にどう動くか」を書き、画像全体を再記述する必要はありません。

パラメータ一覧

パラメータ	値	説明
prompt	文字列	テキスト生成では必須、画像生成ではオプション
image_urls	1～2 枚	画像生成のみ；1 枚は最初のフレーム、2 枚は最初と最後のフレーム
duration	3～15 の整数、デフォルト 5	単位は秒
resolution	720p / 1080p / 4K、デフォルト 1080p	指定しない場合は 1080p で課金
aspect_ratio	16:9 / 9:16 / 1:1、デフォルト 16:9	テキスト生成のみ
sound	デフォルト false	有効にするとセリフ、効果音、環境音を生成

料金を計算

長さ	720p	720p サウンド有効	1080p	1080p サウンド有効	4K
3 秒	$0.30	$0.429	$0.387	$0.579	$1.437
5 秒	$0.50	$0.715	$0.645	$0.965	$2.395
10 秒	$1.00	$1.43	$1.29	$1.93	$4.79
15 秒	$1.50	$2.145	$1.935	$2.895	$7.185

resolution のデフォルトは 1080p なので、プロンプトを調整するときは明示的に 720p を指定すると2割以上節約できます。詳しい料金比較は Kling 3.0 API 料金 を参照。

運用前の注意

• ポーリングの代わりにコールバックを使用：リクエストのトップレベル（input と同じ階層）に "callback": {"url": "https://あなたのドメイン/hiapi/callback"} を追加し、taskId で重複排除。
• 速やかに転送保存：output[0].url は一時リンクなので、取得後すぐに自分のストレージに保存。
• リトライには冪等キー：リクエストヘッダーに Idempotency-Key を追加し、同じキーでのリトライはタスクを1回だけ作成。
• 失敗時は自動返金：成功した動画のみ課金。

よくある質問

プロンプトは中国語で書けますか？

はい。中国語も英語も可能で、セリフの内容も直接プロンプトに書けます。

サウンドは別途料金がかかりますか？

sound: true の場合は単価が高くなります：720p は毎秒 $0.10 から $0.143、1080p は $0.129 から $0.193。映像のみならデフォルトの false のまま。

1本の最大長さは？

3～15 秒。より長い映像は分割生成してから編集。

Kling 3.0 と Seedance 2.5 の選び方は？

Kling 3.0 は単価が安く 4K に対応；Seedance 2.5 は1本最大 30 秒。比較は Kling 3.0 と Seedance 2.5 の違い を参照。

すぐ使える書き方が欲しい場合は Kling 3.0 プロンプトガイド を参照；上の赤狐のプロンプトをコピーして モデルページで生成 することもできます。