Skip to main content
POST
/
v1
/
videos
/
{video_id}
/
remix
Error
A valid request URL is required to generate request examples
{
  "id": "video_def456789abc012345678901234567890123456789",
  "object": "video",
  "created_at": 1762789902,
  "status": "queued",
  "model": "sora-2",
  "prompt": "在结尾添加品牌 Logo",
  "progress": 0,
  "seconds": "4",
  "size": "720x1280",
  "remixed_from_video_id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"
}
Remix 功能允许你基于已生成的视频进行二次创作，通过新的提示词修改视频内容。本文只描述公开兼容页面，不承接经济型分组的时长或扩展字段说明。

​
创建 Remix 任务

基于现有视频 ID 和新的提示词创建 Remix 任务： 
curl -X POST "https://models.kapon.cloud/v1/videos/$VIDEO_ID/remix" \
  -H "Authorization: Bearer $TOKEN" \
  -F "prompt=在结尾添加品牌 Logo"

​
请求参数

  • video_id（路径参数）：原视频任务的唯一标识符
  • prompt（请求体）：Remix 的文本描述，最多 1000 个字符

​
响应示例

{
  "id": "video_def456789abc012345678901234567890123456789",
  "object": "video",
  "created_at": 1762789902,
  "status": "queued",
  "model": "sora-2",
  "prompt": "在结尾添加品牌 Logo",
  "progress": 0,
  "seconds": "8",
  "size": "1280x720",
  "remixed_from_video_id": "video_691209aab0a08198a4e78870277f7e3d0215e09cec47a737"
}

​
使用场景

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

​
工作流程

  1. 首先创建一个基础视频任务
  2. 等待基础视频生成完成（status 为 success）
  3. 使用基础视频的 ID 创建 Remix 任务
  4. 查询 Remix 任务状态，等待完成
  5. 下载 Remix 后的视频
# 1. 创建基础视频
VIDEO_ID=$(curl -X POST "https://models.kapon.cloud/v1/videos" \
  -H "Authorization: Bearer $TOKEN" \
  -F "model=sora-2" \
  -F "prompt=一个无人机从海滩升空" \
  | jq -r '.id')

# 2. 等待完成（轮询查询）
while true; do
  STATUS=$(curl "https://models.kapon.cloud/v1/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $TOKEN" | jq -r '.status')
  if [ "$STATUS" = "success" ]; then break; fi
  sleep 5
done

# 3. 创建 Remix
REMIX_ID=$(curl -X POST "https://models.kapon.cloud/v1/videos/$VIDEO_ID/remix" \
  -H "Authorization: Bearer $TOKEN" \
  -F "prompt=添加日落滤镜效果" \
  | jq -r '.id')

# 4. 下载 Remix 视频
curl -L "https://models.kapon.cloud/v1/videos/$REMIX_ID/content" \
  -H "Authorization: Bearer $TOKEN" \
  --output "remix_$REMIX_ID.mp4"
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 状态下存在