Kling Video V3

3 モデルは PopGo 動画タスク API を共有しますが、画像数、開始・終了フレーム、出力形式が異なります。現行の連携では参照動画・参照音声は公開されていません。サービス資料の「音声」列は参照音声入力の宣言ではありません。

モデルの違い

モデル	画像	出力音声（サービス資料）	解像度
`kling-video-v3`	最大 2 枚。1 枚目が開始、2 枚目が終了フレーム	対応	720p / 1080p / 4K
`kling-video-v3-omni`	参照画像は最大 7 枚	対応	720p / 1080p / 4K
`kling-video-v3-turbo`	開始フレーム 1 枚のみ	音声非対応	720p / 1080p

フィールドと既定値

フィールド	型	規則
`model`	string	必須。上表の公開モデル ID
`prompt`	string	必須。被写体、動作、カメラを記述
`seconds` / `duration`	integer	整数 3–15 秒。明示推奨、画面の既定値は 5 秒
`resolution`	string	モデル別に 720p / 1080p / 4K。画面は 720p、サービスは 4K が既定。Turbo は 4K 非対応
`aspect_ratio`	string	16:9 / 9:16 / 1:1。既定は 16:9。画像入力時は下記参照
`reference_images`	object[]	url または image_url を持つオブジェクト配列。公開 HTTP(S) URL または完全な画像 Data URL

reference_images を使用

直接 API を呼ぶ場合は下記の配列を使用します。PopGo は Canvas のアップロードとフレームフィールドも正規化しますが、複数の別名を同時送信しないでください。ローカル画像は完全な Data URL にできます。共有ページ、ログイン URL、ローカルパスは画像 URL ではありません。

curl -X POST https://api.popgo.site/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "prompt": "A person turns toward the camera",
    "seconds": 5,
    "resolution": "720p",
    "reference_images": [
      {"url": "YOUR_IMAGE_URL"}
    ]
  }'

テキスト生成では reference_images を省略します。画像は配列順に渡します。標準版の 2 枚は開始・終了フレームで、通常のスタイル参照 2 枚ではありません。Omni は被写体・スタイル参照、Turbo は 1 枚までです。

縦横比と出力

資料では標準版に 1024×1536 の開始画像を渡し、2352×3524 の結果を得ています。比率は最初の画像に従います。固定比率が必要なら先にトリミングしてください。aspect_ratio が常に上書きするとは限りません。Canvas は開始フレーム時の比率設定を非表示にします。

資料の Omni 5 秒 4K サンプルは 3840×2160、24 fps、約 5.042 秒、8.9 Mbps、5.6 MB でした。単発の観測であり、固定ビットレートや容量の保証ではありません。

非対応・未確認のフィールド

現行 3 モデルには reference_video、video_reference、reference_audio、動作制御用素材フローはありません。generate_audio は出力音声の指定で、参照音声ではありません。Canvas の現行プリセットではこの出力スイッチも公開していません。Omni という名前だけで動作制御を推測しないでください。

quality など未掲載フィールドは無視される場合があります。HTTP 200 は有効性の証拠ではありません。seed、watermark も一般的な慣習から対応を推測せず、現行仕様と生成結果を確認してください。

状態照会の 4 点

progress は completed / 100 まで 0 のままの場合があります。停止の証拠ではなく、中間値を作らないでください。
照会時の model が空の場合があります。送信したモデル ID を保持してください。
usage がなくても無料とは限りません。PopGo の利用・請求記録を確認してください。
解像度、長さ、fps が返らない場合はダウンロード後に測定します。タイムスタンプも正確な処理時間とは限りません。

資料の 3 回の処理時間は約 140、200、420 秒。10 秒間隔で照会し、少なくとも 15 分の待機を想定してください。時間保証ではありません。タイムアウト後も元タスクを照会し、再作成しないでください。

エラーと修正

現象	対処
400 パラメータ不正	長さ、比率、解像度、画像数を確認。同じまま再試行しない
404 モデル・タスクなし	公開モデル ID、トークン権限、PopGo のタスク ID を確認
503 利用可能アカウントなし / 502 一時障害	回数制限付きバックオフ。作成タイムアウト後はタスクの有無を確認
画像が反映されない	実際の reference_images、素材アクセス、結果を比較。ID だけでは反映を証明しない
Turbo で 4K または音声指定	非対応フィールドを削除し 720p / 1080p を使用

PopGo の /content または返された利用可能な結果 URL から取得します。大容量ファイルには十分なタイムアウトを設定し、外部メディアホストへ PopGo API Key を送らないでください。動画タスクと料金を参照してください。

モデルの違い​

フィールドと既定値​

reference_images を使用​

縦横比と出力​

非対応・未確認のフィールド​

状態照会の 4 点​

エラーと修正​