Kuaishou

Kling 3.0

kling-3.0/text-to-video

統合マルチモーダル動画生成シリーズ。テキストから動画、画像から動画、参照から動画、動画内編集に対応し、ネイティブなリップシンクと多言語音声を備える

kling-3.0-omni/image-to-video kling-3.0-omni/reference-to-video kling-3.0-omni/text-to-video kling-3.0-omni/transformation kling-3.0/image-to-video kling-3.0/motion-control kling-3.0/text-to-video

kling-3.0/text-to-video を試す

入力

作品ギャラリー

すべての作品を見る

出力

video

パラメータを入力して生成すると、結果がここに表示されます。

料金

kling-3.0/text-to-video per second

仕様	720P	1080P	4K
Sound Off	$0.100	$0.129	—
Sound On	$0.143	$0.193	—
—	—	—	$0.479

概要

kling-3.0/text-to-video は Kling 3.0 シリーズのテキスト・トゥ・ビデオ機能です。テキスト記述を入力するだけで、オプションのネイティブ音声付きの完成動画を生成できます。3〜15秒の長さ、720p〜4K の解像度、横画面・縦画面・正方形の3種類のアスペクト比に対応しており、脚本やアイデアを素早く公開可能な動画にしたい開発者やコンテンツチームに適しています。秒単位の課金なので、動画の長さに応じてコストを管理できます。

主な特長

ネイティブ音声付きのテキスト・トゥ・ビデオ——音声オプションを有効にすると、映像に同期した効果音や環境音を生成でき、別途音声を付ける手間が省けます。
主要な配信ニーズをカバーする解像度とアスペクト比——720p、1080p、4K の3段階の解像度と 16:9、9:16、1:1 のアスペクト比に対応し、1回の呼び出しで横画面・縦画面・正方形の配信にマッチします。
ナラティブに合わせて調整できる長さ——1回の生成で3〜15秒に対応し、短編もマルチショットの断片も同じインターフェース内で完結します。

機能説明

テキストのみから完成動画へ：プロンプトを送信するだけで動画を出力でき、脚本やコピーはあるが素材が不足しているチームの迅速な制作に適しています。

ネイティブ音声と無音の二択：同期効果音や環境音を有効にするか、音声をオフにして映像のみを出力するかを選択でき、後から独自に音楽や音声を付けることも容易です。

解像度とアスペクト比のパラメータ化：解像度とアスペクト比のパラメータで出力仕様を直接制御できるため、生成後のトリミングや拡大縮小による画質劣化を抑えられます。

長さとコストの連動：出力秒数に応じた課金なので、長さを短くしたり解像度を下げたりすることで1本あたりのコストを抑えられ、バッチでの試作に便利です。

想定される用途

マーケティングチームがコピーから広告ショート動画を素早く制作——配信コピーを 9:16 または 16:9 の完成動画に変換し、フィード広告やブランドショート動画の配信にそのまま活用できます。
コンテンツクリエイターが縦型ショート動画を大量生産——テーマごとに 9:16 のショート動画素材をバッチ生成し、SNS の日常的な更新に使用できます。
実写素材がないときに絵コンテのアイデアを検証——テキスト記述で短い断片を生成してカメラワークの効果をプレビューし、事前の絵コンテ作成やアイデアレビューに活用できます。

制限と選定のアドバイス

1回の生成の長さの上限は15秒で、長いナラティブは分割して生成した後に結合する必要があります。ネイティブ音声は効果音と環境音のみをカバーし、セリフやリップシンクは含まないため、対話内容には別途音声を用意するか、シリーズ内の別の機能に切り替える必要があります。解像度、長さ、音声のオン/オフはいずれも費用に影響するため、大量生産の前に低解像度の短い動画で効果を検証することをおすすめします。参照画像がある場合や動作制御が必要な場合は、同シリーズのイメージ・トゥ・ビデオまたは動作制御機能を選択してください。

よくある質問

よくある質問を見る →

Kling 3.0 Image-to-Video は画像をアップロードする必要がありますか？

必要です。現在 kling-3.0/image-to-video は画像から動画を生成するラインであり、入力画像が主体と開始時の構図を担い、Prompt が動作、カメラワーク、環境の変化を担います。
Kling 3.0 Image-to-Video はどのような長さと解像度に対応していますか？

現在の HiAPI リクエスト契約では 3～15s に対応しており、出力解像度は 720p、1080p、4K です。選択可能な値はページのパラメータパネルおよび API ドキュメントに準拠します。
Kling 3.0 Image-to-Video の料金はどのように計算されますか？

タスクは出力時間と選択したティアに基づいて課金されます。ページにはグローバルな金額単位に従ってリアルタイムの価格が表示され、最終的な請求は成功したタスクの記録に基づきます。
画像から動画を生成する際の被写体の安定性をどう高めますか？

被写体がはっきりしており、遮蔽が少なく、構図が完全な入力画像を使用してください。Prompt ではまず主な動作とカメラワークを記述し、その後、必ず保持すべき外観、素材、背景との関係を列挙します。初回テストでは短めの再生時間を使用することをお勧めします。

生成タスクの作成

POST https://api.hiapi.ai/v1/tasks

ヘッダー

Authorizationstring必須

アカウントの API キー。すべてのリクエストで必須です。例：Bearer YOUR_HIAPI_API_KEY。API キーを取得

Content-Typestring任意

リクエストボディは常に JSON として解析されます。送信する場合は application/json（charset 付き可）のみ受け付け、他の値は 415 を返します。例：application/json。

Idempotency-Keystring任意

冪等キー。最大 255 バイト。同じアカウントで同じキーの再試行はタスクを 1 つだけ作成し、リプレイは最初の taskId を返します。

冪等キー

ネットワークタイムアウトやクライアントの自動再試行時、同じキーではタスクを 1 回だけ作成し、二重課金は発生しません（適用範囲 = API キーのアカウント）。業務側の一意識別子（例："order-42"）をキーに使うことを推奨します。同じキーのリプレイは最初の taskId を返し、キーは初回送信から 24 時間で失効します。詳細なシナリオ表は統一非同期 API の紹介ページをご覧ください。

ボディ

modelstring必須

現在の固定値：kling-3.0/text-to-video

routestring任意

現在の固定値：default

inputobject必須

kling-3.0/text-to-video とルート default の業務パラメータオブジェクト。下のパラメータ表を参照してください。

soundboolean任意デフォルト: false

画面と同期する効果音/環境音を生成するかどうか。オンにすると呼び出し費用が高くなります。ブール値、デフォルトは false。

promptstring必須

生成する動画の内容を記述するテキストプロンプト。文字列。

durationinteger任意デフォルト: 5min 3max 15

動画クリップの長さ（秒単位）、値は 3〜15。費用は長さに応じて増加します。デフォルトは 5 秒。

resolutionstring任意デフォルト: "1080p"

出力動画の解像度。文字列。解像度が高いほど費用が高くなります。デフォルトは 1080p。

オプション：720p1080p4K

aspect_ratiostring任意デフォルト: "16:9"

出力動画のアスペクト比。文字列。デフォルトは 16:9。

オプション：16:99:161:1

callbackobject任意

終了状態の通知設定。省略した場合はコールバックされず、呼び出し側でポーリングします。

コールバック（Webhook）

作成時に callback.url を指定すると、タスク終了時に HiAPI があなたのサービスへ POST し、ポーリングが不要になります。コールバックのリクエストボディはタスク詳細と同構造です。署名検証・再送・冪等の詳細は統一非同期 API 紹介ページのコールバック説明を参照してください。

urlstring必須

callback を指定する場合は必須。タスク終了後にこの URL へ POST します。有効な http(s) URL である必要があります。

whenstring任意デフォルト: "final"

現在は final のみ対応（success / fail の両方で通知）。

オプション：final

storagestring任意デフォルト: "temp"

成果物の保存期間：temp（デフォルト・約 7 日）または persistent（長期保存・サイズ課金）。残高不足や保存上限超過の場合は temp に自動降格します。実際に適用された段階はタスク詳細レスポンスで確認できます。

オプション：temppersistent

リクエスト例

# 非同期タスクを送信。成功すると即座に taskId を返します（生成完了は待ちません）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0/text-to-video",
  "input": {
    "sound": false,
    "prompt": "…",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "kling-3.0/text-to-video",
    input: {
      "sound": false,
      "prompt": "…",
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "kling-3.0/text-to-video",
        "input": {
          "sound": False,
          "prompt": "…",
          "duration": 5,
          "resolution": "1080p",
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

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

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

タスク詳細の取得

GET https://api.hiapi.ai/v1/tasks/:id

レスポンスフィールド

taskIdstring必須

タスク ID。先頭は固定で tk-hiapi-。

modelstring必須

解決済みのモデル完全名。route パラメータで送信したタスクは base@route（例：gpt-image-2/text-to-image@ext）を返し、それ以外は送信時のモデル名と同一です。

routestring任意

route パラメータを明示して送信したタスクでのみ出現し、送信時の値をエコーします。

statusstring必須

タスク状態。

ステータス値

queued キュー投入済み、未開始。 handling 処理中。 archiving 処理完了、成果物準備中。 success 終端：完了。成果物利用可能（output を返却）。 fail 終端：失敗（error を返却）。送信後は status で判断します：success と fail が終端、それ以外は非終端です。1〜3 秒間隔で終端までポーリングすることを推奨します。成功したら output[].url から成果物をダウンロードし、expireAt までに保存先へ転送してください。長期保存が必要な場合は作成時に storage: "persistent" を指定します。

creatednumber必須

タスク作成時刻（Unix 秒）。

completednumber必須

終了状態になった Unix 秒。非終端では 0 固定。

outputarray任意

status == success のときのみ出現。成果物リスト — 常に配列で、1 タスクで複数の type を同時に返すことがあります（例：video + first_frame）。

Array [ object ]

配列要素

urlstring必須

成果物の URL。直接ダウンロードできます。

typestring必須

現在の候補値：video、image、audio、first_frame、last_frame、thumbnail。今後拡張される可能性があります。

expireAtnumber必須

成果物にアクセスできる期限（Unix 秒）。期限までにダウンロードまたは転送してください。

errorobject任意

status == fail のときのみ出現。

codestring必須

業務エラーコード。

messagestring必須

エラーの説明。

レスポンス例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

処理中（非終端）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失敗

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}