Skip to main content
Remix 功能允许您修改现有视频的特定方面,同时保留其核心元素。通过引用之前成功完成的视频 ID,并提供更新的提示词,系统会维持原始视频的框架、场景转换和视觉布局,同时实现您请求的更改。
为获得最佳效果,请将修改限制在一个明确的调整上。精确、聚焦的编辑能更好地保持与源素材的一致性,并最大限度地减少生成视觉缺陷的可能性。

路径参数

video_id
string
required
之前已完成的视频 ID,用于进行 remix。示例:"video_01K8SGYNNNVBQTXNR4MM964S7K"

请求参数

model
string
required
视频生成模型名称。Azure Sora 2 remix 必须使用 sora-2-official示例:"sora-2-official"
prompt
string
required
重混视频的更新文本描述,描述您想对原始视频进行的具体更改。保持精确并专注于一个明确的修改。示例:"将色彩调整为青色、沙色和铁锈色,配合温暖的背光"

请求示例

curl --request POST \
  --url https://geekapis.com/v1/videos/video_01K8SGYNNNVBQTXNR4MM964S7K/remix \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-official",
    "prompt": "将色彩调整为青色、沙色和铁锈色,配合温暖的背光"
  }'

返回示例

200
{
  "id": "video_68ff7cef76cc8190b7eab9395e936d9e",
  "object": "video",
  "model": "sora-2-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1761574127,
  "remixed_from_video_id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "seconds": "8",
  "size": "1280x720"
}

响应字段

字段类型说明
idstring重混视频的唯一任务标识符
objectstring对象类型,固定为 video
modelstring使用的模型名称
statusstring任务状态:queued / in_progress / completed / failed
progressinteger任务进度百分比(0–100)
created_atinteger任务创建时间戳(Unix 时间戳)
remixed_from_video_idstring被重混的原始视频 ID
secondsstring视频时长(秒)
sizestring视频分辨率(如 "1280x720"

查询任务状态

提交后,使用以下接口轮询任务进度:
GET https://geekapis.com/v1/videos/generations/{task_id}