Kling v4 Flash 動画生成 | ToAPIs Documentation

POST

/v1/videos/generations

3 つの入力モードで共通の kling-4.0-flash を使用します. 素材から生成経路を自動選択します. 非同期 API のため, 送信後はプラットフォームのタスク ID で結果を照会します.

プラットフォームの API キーを使用します. 中国本土では https://toapis.com を https://toapis.cn に置き換えられます. 利用可否はデプロイ済みチャネル設定とアカウント権限に依存します.

入力モード

モード	リクエスト内容
テキストから動画	プロンプトと出力仕様のみを送信します. 素材は不要です.
参照素材	`image_urls` / `video_urls` または reference ロールの素材を使用します. 画像と動画は併用できます.
最初のフレーム	`image_with_roles` で `first_frame` を 1 枚だけ明示します. 参照画像や動画とは併用できず, 中間・最後のフレームは非対応です.

リクエストパラメータ

Authorizationstringヘッダー必須

Bearer YOUR_API_KEY で認証します.

modelstringボディ必須

常に kling-4.0-flash. モード間でモデル ID を変更しません.

promptstringボディ必須

必須, 空白のみは不可. Unicode 文字で最大 8000 文字. 主体, 動作, カメラと素材の関係を記述します.

durationintegerボディデフォルト: 5

3-20 秒の整数. 既定値は 5.

resolutionstringボディデフォルト: 720p

720p のみ. 既定値は 720p.

aspect_ratiostringボディ

auto, 16:9, 9:16, 1:1, 21:9. 省略時は上流の既定値を維持します. 自動比率には auto を明示できます.

image_urlsstring[]ボディ

参照画像 URL 配列, 最大 10 枚. 配列位置から最初のフレームを推測しません. reference 画像ロールと合算するため同じ素材を重複させないでください.

video_urlsstring[]ボディ

参照動画 URL 配列. video_with_roles と合計で最大 5 本.

image_with_rolesobject[]ボディ

各オブジェクトは url と role を持ちます. reference / reference_image は参照画像, first_frame は最初のフレームです. keyframe と last_frame は非対応です.

video_with_rolesobject[]ボディ

各オブジェクトは url と role を持ちます. reference / reference_video に対応します.

metadataobjectボディ

真偽値 keep_original_sound で参照動画の元音声を保持します. 例: {"keep_original_sound": true}. 参照動画のみで使用します. 最初のフレームでは false でもこのキーを送信できません.

client_business_idstringボディ

任意の顧客業務 ID. タスクに保存され, 同じ照会 API で利用できます.

素材ルールと検証

公開アクセス可能な HTTP(S) URL を使用し, ユーザー名やパスワードを含めないでください. ローカル素材は画像アップロードまたは動画アップロードで URL を取得します. ローカルパスや base64 は送信しません.
参照モードは最大 10 画像と 5 動画. 通常配列と明示 reference ロールは合算されるため, 同じ素材を重複送信しないでください.
最初のフレームモードは first_frame 1 枚のみ受け付け, keyframe と last_frame は拒否されます. 最初のフレームはロールで決まり, 通常画像の位置から推測しません.
最初のフレームと参照素材は排他的です. 旧 Kling の mode, audio, video_list や Omni 引用構造は使用しません. audio_with_roles, metadata.elements, metadata.voices は非対応です.
不正な仕様, ロール, URL, 数量, モードの組み合わせは拒否されます. エラーを修正してから再送信してください. 本ページはサイズ, コーデック, 入力動画の長さの上限を保証しません. アップロードサービスと上流の要件も満たしてください.

リクエスト例

テキストから動画

{
  "model": "kling-4.0-flash",
  "prompt": "夕日の海岸に打ち寄せる波, ゆっくり前進するカメラ",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

参照素材

{
  "model": "kling-4.0-flash",
  "prompt": "参照画像の人物を維持し, 参照動画のカメラワークを使う",
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/character.png"
  ],
  "video_urls": [
    "https://example.com/motion.mp4"
  ],
  "metadata": {
    "keep_original_sound": true
  }
}

最初のフレーム

{
  "model": "kling-4.0-flash",
  "prompt": "最初のフレームを起点に, 人物がゆっくり窓の外へ向きを変える",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_with_roles": [
    {
      "url": "https://example.com/first.png",
      "role": "first_frame"
    }
  ]
}

タスク送信

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-4.0-flash",
  "prompt": "夕日の海岸に打ち寄せる波, ゆっくり前進するカメラ",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

レスポンス例

{
  "id": "task_example",
  "object": "generation.task",
  "model": "kling-4.0-flash",
  "status": "queued",
  "created_at": 1792713600
}

タスク照会と課金

レスポンスの id はプラットフォームのタスク ID です. 供給元 task_id ではなく下記 API で照会します. 状態は queued, in_progress, completed, failed. 詳細は動画タスク状態とタスク Webhookを参照してください.

curl --request GET \
  --url https://toapis.com/v1/videos/generations/YOUR_TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

既定値は 5 秒 / 720p. 明示指定で出力仕様を管理できます. 固定価格や旧 Sound 課金との同一性は保証しません. 実際の料金はアカウント見積もりとタスクの usage / billing に従います.