跳轉到主要內容
POST
/
kling
/
v1
/
videos
/
multi-elements
Create a Kling multimodal edit task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-elements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "784914037360041984",
  "edit_mode": "replace",
  "prompt": "Replace the selected object with a red paper boat."
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
使用此端點可在您的工作階段與選項準備完成後,提交最終的多模態影片編輯工作。

完整流程

1

初始化編輯工作階段

先使用 Initialize Video for Editing 取得您要編輯之片段的 session_id
2

建立選取區域

使用 Add Video Selection,並在需要時搭配 Preview Selected Video Area 來微調編輯區域。
3

提交最終任務

透過此端點傳送 session_idedit_mode 和最終 prompt,然後儲存回傳的 task id 以便查詢狀態。

呼叫前須知

  • 請確認選取工作階段已完成初始化
  • 在消耗一次生成呼叫前,請確認您的區域選取正確無誤
  • 請將此路由視為最終生成步驟,而非設定步驟
如需完整參數參考,請參閱 Kling API documentation

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

主體

application/json
session_id
string
預設值:784914037360041984
必填

Session id returned by the video initialization endpoint.

edit_mode
string
預設值:replace
必填

Editing operation to apply. Options: replace, remove.

prompt
string
預設值:Replace the selected object with a red paper boat.
必填

Text prompt describing the desired edit for the selected region.

回應

200 - application/json

Task accepted.

code
integer
必填
message
string
必填
data
object
必填