建立任務 - CometAPI Documentation

POST

kling

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
  }
}

使用此端點可在您的工作階段與選項準備完成後，提交最終的多模態影片編輯工作。

完整流程

初始化編輯工作階段

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

建立選取區域

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

提交最終任務

透過此端點傳送 session_id、edit_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

必填

Show child attributes

預覽所選影片區域

文字轉影片

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
  }
}

Documentation Index

​完整流程

​呼叫前須知

授權

主體

回應

完整流程

呼叫前須知