基于已有视频任务使用 Sora-2-characters-pro 高级 AI 模型创建动态角色动画
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
origin_task_id | string | 是 | 原先任务的 task_id |
timestamps | string | 是 | 视频时间戳。格式:"x,y"(例如:"3.55,5.55")。截取从 x 秒到 y 秒的片段,时长(y - x)必须在 1-4 秒之间 |
character_user_name | string | 否 | 可选。角色的自定义名称,用于在后续操作中标识和引用。若提供则小于 40 字符 |
character_prompt | string | 是 | 角色人设提示词,非空,描述角色的个性和外观 |
safety_instruction | string | 否 | 角色安全指令,动画的安全指南和内容限制 |
state: "success")时,resultJson 字段包含:
character_id 可用于在后续操作中引用生成的角色动画。
所有 API 都需要通过 Bearer Token 进行身份验证。
获取 API Key:
使用方法: 在请求头中添加: Authorization: Bearer YOUR_API_KEY
注意事项:
要使用的模型名称。必需字段。
sora-2-characters-prosora-2-characters-pro "sora-2-characters-pro"
用于接收生成任务完成更新的 URL。可选但推荐用于生产环境。
"https://your-domain.com/api/callback"
生成任务的输入参数
请求成功
响应状态码
200, 401, 402, 404, 422, 429, 455, 500, 501, 505 响应消息,失败时为错误描述
"success"