Skip to main content
POST
Remix 视频
Remix 功能允许你基于已生成的视频进行二次创作,通过新的提示词修改视频内容。本文只描述公开兼容页面,不承接经济型分组的时长或扩展字段说明。

创建 Remix 任务

基于现有视频 ID 和新的提示词创建 Remix 任务:

请求参数

  • video_id(路径参数):原视频任务的唯一标识符
  • prompt(请求体):Remix 的文本描述,最多 1000 个字符

响应示例

使用场景

Remix 功能适用于以下场景:
  • 添加元素:在视频中添加 Logo、文字或其他视觉元素
  • 调整风格:改变视频的色调、滤镜或艺术风格
  • 修改细节:调整视频中的特定对象或场景
  • 延长内容:在视频开头或结尾添加新的场景

工作流程

  1. 首先创建一个基础视频任务
  2. 等待基础视频生成完成(status 为 success
  3. 使用基础视频的 ID 创建 Remix 任务
  4. 查询 Remix 任务状态,等待完成
  5. 下载 Remix 后的视频
Remix 任务会继承原视频的基本参数(如分辨率、时长),但会根据新的提示词进行内容调整。若你在平台中同时接入经济型分组和官方渠道,请按 Sora 视频路由与分组 隔离契约边界。
原视频必须处于可用终态后才能进行 Remix。当前实现中终态成功值为 success。Remix 任务会消耗与创建新视频相同的配额。

Authorizations

Authorization
string
header
required

使用 API Key 作为 Bearer Token

Path Parameters

video_id
string
required

原视频任务的唯一标识符

Body

multipart/form-data
prompt
string
required

Remix 的文本描述

Maximum string length: 1000
Example:

"在结尾添加品牌 Logo"

Response

Remix 任务创建成功

id
string

视频任务的唯一标识符

Example:

"video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"

object
enum<string>

对象类型

Available options:
video
Example:

"video"

created_at
integer

创建时间戳(Unix 时间)

Example:

1762789802

completed_at
integer

任务完成时间戳(仅在 success 状态下存在)

Example:

1762789891

expires_at
integer

视频过期时间戳(仅在 success 状态下存在)

Example:

1762793491

model
string

使用的模型名称

Example:

"sora-2"

status
enum<string>

任务状态

Available options:
queued,
processing,
success,
failed
Example:

"queued"

prompt
string

生成视频的文本描述

Example:

"一个无人机从海滩升空拍摄夕阳"

progress
integer

处理进度(0-100)

Required range: 0 <= x <= 100
Example:

0

seconds
string

视频时长(字符串格式)

Example:

"8"

size
string

视频分辨率

Example:

"720x1280"

assets
object[]

生成的视频资源数组,仅在 success 状态下存在(部分供应商可能不返回此字段,需通过 /content 端点下载)

remixed_from_video_id
string

Remix 来源视频 ID(仅 Remix 任务返回)

Example:

"video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"

error
object

错误信息,仅在 failed 状态下存在