Skip to main content
POST
cURL
使用此端點可套用 Kling 的其中一個預設特效場景,將輸入素材轉換為新的短影片。

選擇特效場景

  • 單張圖片特效使用 effect_scene 搭配 input.imageinput.duration
  • 雙人互動特效使用 effect_scene 搭配 input.images,且必須剛好提供兩張圖片
  • 輸入圖片必須符合 Kling 的像素要求;過小的縮圖會被生成任務拒絕
  • 確切的素材格式取決於所選特效,但請求一律會將特效設定包在 input
  • 請使用目前 Kling 可用的特效場景;CometAPI 會拒絕未知的 effect_scene
  • 避免依賴固定的公開 enum 清單;特效可用性會隨 model track 與場景家族而變動

任務流程

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
必填