跳转到主要内容
POST
https://toapis.com
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "url": "https://example.com/character-video.mp4",
    "timestamps": "1,3"
  }'

{
  "id": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
  "object": "generation.task",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}
  • Sora2 角色创建功能
  • 从视频中提取角色用于后续生成
  • 支持从视频 URL 或已生成的任务创建角色
  • 异步任务管理，通过任务 ID 查询结果

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key

​
Body

​
model
string
默认值:"sora-2"
必填
模型名称示例："sora-2" 或 "sora-2-pro"
​
url
string
包含角色的视频 URL与 from_task 二选一
​
from_task
string
已生成视频的任务 ID与 url 二选一
​
timestamps
string
必填
角色出现的时间戳指定参考视频中角色出现的时间范围，仅支持 2 秒片段格式："start_second,end_second"示例："1,3" 表示参考视频中第 1 秒到第 3 秒的角色
注意：
  • 视频必须包含声音和角色
  • url 和 from_task 二选一，必须提供其中一个
  • 时间范围固定为 2 秒片段（例如：1-3 秒）
  • 此模式下不需要 prompt 参数
  • 创建的角色可以通过 @username 格式在后续视频生成中引用

​
Response

​
id
string
任务唯一标识符，用于查询角色创建状态
​
object
string
对象类型，固定为 generation.task
​
model
string
使用的模型名称
​
status
string
任务状态
  • queued - 排队等待处理
  • in_progress - 处理中
  • completed - 成功完成
  • failed - 失败
​
progress
integer
任务进度百分比（0-100）
​
created_at
integer
任务创建时间戳（Unix 时间戳）
​
metadata
object
任务元数据
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "url": "https://example.com/character-video.mp4",
    "timestamps": "1,3"
  }'

{
  "id": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
  "object": "generation.task",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}