Skip to main content
POST
cURL
このエンドポイントを使用すると、Kling のプリセットエフェクトシーンの1つを適用し、入力アセットを新しい短い動画に変換できます。

エフェクトシーンを選ぶ

  • 単一画像のエフェクトでは、effect_scene に加えて input.imageinput.duration を使用します
  • 2人のインタラクションエフェクトでは、effect_scene に加えて、ちょうど2枚の画像を含む input.images を使用します
  • 入力画像は Kling のピクセル要件を満たしている必要があります。小さすぎるサムネイルは生成タスクで拒否されます
  • 正確なアセット形式は選択したエフェクトによって異なりますが、リクエストでは常にエフェクト設定を input 内に含めます
  • Kling で現在利用可能なエフェクトシーンを使用してください。CometAPI は不明な effect_scene の値を拒否します
  • 公開された enum の固定リストに依存しないでください。エフェクトの利用可否は model track や scene family によって変わります

タスクフロー

1

エフェクトリクエストを送信する

effect_scene と対応する input オブジェクトを送信し、返された task id を保存します。
2

タスクをポーリングする

エフェクトジョブが完了するまで、Kling タスクを取得する を続けてください。
3

最終アセットを保存する

安定した保持が必要な場合は、完成したエフェクト動画をダウンロードまたはミラーリングしてください。
完全なパラメータリファレンスについては、Kling の公式ドキュメント を参照してください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json
effect_scene
string
必須

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
必須

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

レスポンス

200 - application/json

Task accepted.

code
integer
必須

Error code; specific error code definition

message
string
必須

Error message

data
object
必須