跳轉到主要內容
POST
/
v1
/
videos
/
{video_id}
/
remix
Create a Sora remix job
curl --request POST \
  --url https://api.cometapi.com/v1/videos/{video_id}/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Shift the color palette to teal, sand, and rust, with a warm backlight."
}
'
{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "progress": 123,
  "created_at": 123,
  "size": "<string>",
  "seconds": "<string>",
  "remixed_from_video_id": "<string>"
}
使用此端點可為已完成的 Sora 影片建立變體,而無需從頭開始。當你將變更範圍維持得精確且明確時,Remix 的效果最佳。

良好的 remix prompt

  • 提出一個清楚的變更,而不是重寫整個場景
  • 對光線、色調、鏡頭運動或氛圍的描述要具體
  • 請從已完成的來源影片開始,而不是使用進行中的任務

Remix 流程

1

先完成基礎渲染

使用建立影片建立來源影片,並等待其完成。
2

提交 remix 請求

傳入已完成的 video_id,並搭配描述單一聚焦變更的 prompt。
3

輪詢並下載 remix 結果

將 remix 回應視為新的非同步任務,使用取得影片輪詢其狀態,然後再用取得影片內容下載。

與 OpenAI 的對應方式

這遵循 OpenAI 文件中記載的 remix 模式。CometAPI 保留相同的概念,但整個工作流程都使用 CometAPI 的 base URL 與驗證模型。

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

路徑參數

video_id
string
必填

Completed source video id.

主體

application/json
prompt
string
必填

Describe the change you want to make to the existing video.

範例:

"Shift the color palette to teal, sand, and rust, with a warm backlight."

回應

200 - application/json

Remix job accepted.

id
string
必填
object
string
必填
model
string
必填
status
string
必填
progress
integer
必填
created_at
integer
必填
size
string
必填
seconds
string
必填
remixed_from_video_id
string
必填