Sora2 - Characters Pro
POST
/api/v1/jobs/createTask
Create dynamic character animations from existing video tasks using Sora-2-characters-pro advanced AI model
Prerequisites
1.
2.
taskId from the response. This becomes your origin_task_id.3.
timestamps parameter to define which segment of the video to use. Format: "x,y" (e.g., "3.55,5.55"). The segment duration (y - x) must be between 1-4 seconds.4.
origin_task_id, timestamps, and character_prompt to generate character animations. Optionally include character_user_name to identify the character for reference.Parameter Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
origin_task_id | string | Yes | Task ID of the original video generation task |
timestamps | string | Yes | Video segment time range. Format: "x,y" (e.g., "3.55,5.55"). Extracts segment from x to y seconds. Duration (y - x) must be 1-4 seconds |
character_user_name | string | No | Optional. Custom name for the character, used to identify and reference in subsequent operations. Max 40 characters when provided |
character_prompt | string | Yes | Character persona prompt describing personality and appearance |
safety_instruction | string | No | Safety guidelines and content restrictions for the animation |
CAUTION
timestamps parameter must define a segment between 1-4 seconds. For example, "3.55,5.55" extracts a 2-second segment. Invalid durations will cause processing errors.TIP
Query Task Status
Task Query Response Format
state: "success"), the resultJson field contains:{
"character_id": "example_123456789"
}character_id can be used to reference the generated character animation in subsequent operations.TIP
callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.Related Resources
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": "A friendly cartoon character with expressive eyes and fluid movements",
"safety_instruction": "Ensure the animation is family-friendly and contains no violent or inappropriate content"
}
}'Response Response Example
200 - 成功示例
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_sora-2-characters-pro_1765174270120"
}
}