跳转到主要内容
GET
https://toapis.com
/
v1
/
characters_tasks
/
{task_id}
curl --request GET \
  --url 'https://toapis.com/v1/characters_tasks/task_01KBZ0TZZ7C7M3WS1TJM0PH8J4' \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "actual_time": 46,
    "completed": 1765251507,
    "created": 1765251461,
    "estimated_time": 30,
    "id": "task_01KC0JZCMTMQ70D68XTM56Q5D0",
    "progress": 100,
    "result": {
      "characters": [
        {
          "display_name": "Turbo Whiskers",
          "id": "ch_6937998961208191a45ef08447a554df",
          "profile_picture_url": "https://upload.apimart.ai/f/image/9998234748474202-d5305f13-3dec-4420-9cae-2f5a6a809719-character_task_01KC0JZCMTMQ70D68XTM56Q5D0.jpg",
          "username": "duksvfkf.turbo_whis"
        }
      ]
    },
    "status": "completed"
  }
}
  • 查询角色创建任务的状态
  • 获取已创建角色的详细信息
  • 用于获取角色 ID 以进行后续视频生成

​
Path Parameters

​
task_id
string
必填
角色创建任务 ID这是从创建角色 API 返回的任务 ID示例："task_01KBZ0TZZ7C7M3WS1TJM0PH8J4"

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Response

​
code
integer
响应状态码，成功时为 200
​
data
object
响应数据对象
curl --request GET \
  --url 'https://toapis.com/v1/characters_tasks/task_01KBZ0TZZ7C7M3WS1TJM0PH8J4' \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "actual_time": 46,
    "completed": 1765251507,
    "created": 1765251461,
    "estimated_time": 30,
    "id": "task_01KC0JZCMTMQ70D68XTM56Q5D0",
    "progress": 100,
    "result": {
      "characters": [
        {
          "display_name": "Turbo Whiskers",
          "id": "ch_6937998961208191a45ef08447a554df",
          "profile_picture_url": "https://upload.apimart.ai/f/image/9998234748474202-d5305f13-3dec-4420-9cae-2f5a6a809719-character_task_01KC0JZCMTMQ70D68XTM56Q5D0.jpg",
          "username": "duksvfkf.turbo_whis"
        }
      ]
    },
    "status": "completed"
  }
}

​
使用角色生成视频

创建角色后，可以在视频生成时使用角色： 
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "@duksvfkf.turbo_whis is dancing in the rain",
    "character_url": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
    "character_timestamps": "1,3",
    "aspect_ratio": "16:9"
  }'
在 prompt 中使用 @username 来引用创建的角色（username 从查询结果中获取）。