Sora2 - Characters
POST
/api/v1/jobs/createTask
File Upload Requirements
Step 1: Upload Character Videos
Step 2: Get Upload URLs
character_file_url parameter.Step 3: Submit Animation Task
Additional Parameters
character_prompt: Description of the character and desired animation style (Max 5000 characters)safety_instruction: Safety guidelines and content restrictions for the animation (Max 5000 characters)File Storage Notice:
callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.Query Task Status
Task Query Response Format
state: "success"), the resultJson field contains:{
"character_id": "example_123456789"
}Related Resources
| Resource | Description |
|---|---|
| Market Overview | Explore all available models |
| File Upload API | Learn how to upload your character videos |
| Common API | Check credits and account usage |
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",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"character_file_url": [
"https://static.aiquickdraw.com/tools/example/character1.mp4"
],
"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
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_sora-2-characters_1765174270120"
}
}