Sora2 - Characters Pro
POST
/api/v1/jobs/createTask
前置条件
1.
2.
taskId。这将成为您的 origin_task_id。3.
timestamps 参数定义要使用视频的哪个片段。格式："x,y"（例如 "3.55,5.55"）。片段持续时间（y - x）必须在 1-4 秒之间。4.
origin_task_id、timestamps 和 character_prompt 以生 成角色动画。可选地包含 character_user_name 以标识角色供后续引用。参数参考
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
origin_task_id | string | 是 | 原始视频生成任务的任务 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 | 否 | 动画的安全指南和内容限制 |
时间戳限制
timestamps 参数必须定义 1-4 秒的片段。例如，"3.55,5.55" 提取一个 2 秒的片段。无效的持续时间将导致处理错误。查询任务状态
任务查询响应格式
state: "success"），resultJson 字段包含：{
"character_id": "example_123456789"
}character_id 可用于在后续操作中引用生成的角色动画。callBackUrl 参数在生成完成时接收自动通知，而不是轮询状态端点。相关资源
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "sora-2-characters-pro",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"origin_task_id": "7118f712c1f35c9b8bf2ad1af68ad482",
"timestamps": "3.55,5.55",
"character_user_name": "my_character_01",
"character_prompt": "一个友好的卡通角色，有着富有表现力的眼睛和流畅的动作",
"safety_instruction": "确保动画适合家庭观看，不包含暴力或不适当的内容"
}
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_sora-2-characters-pro_1765174270120"
}
}