Sora2 - Characters
POST
/api/v1/jobs/createTask
文件上传要求
上传角色视频
访问我们的文件上传 API 来上传您的角色视频。要求： 文件类型：MP4、WebM 或 AVI 格式 持续时间：每个视频 1-4 秒之间 最大文件大小：每个文件 10MB 内容：您想要制作动画的角色动作或动作 每个动画任务只能上传一个角色视频。
获取上传 URL
成功上传后，您将收到可用于
character_file_url 参数的文件 URL。提交动画任务
在您的 API 请求中使用获得的 URL 来生成角色动画。
附加参数
character_prompt：角色描述和期望的动画风格（最多 5000 个字符）safety_instruction：动画的安全指南和内容限制（最多 5000 个字符）查询任务状态
查询任务详情响应格式
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",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"character_file_url": [
"https://static.aiquickdraw.com/tools/example/character1.mp4"
],
"character_prompt": "一个友好的卡通角色，有着富有表现力的眼睛和流畅的动作",
"safety_instruction": "确保动画适合家庭观看，不包含暴力或不适当的内容"
}
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "7118f712c1f35c9b8bf2ad1af68ad482"
}
}