Перейти к основному содержанию
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 персонажа для использования в последующей генерации видео

​
Параметры пути

​
task_id
string
обязательно
ID задачи создания персонажаЭто ID задачи, возвращенный из API создания персонажаПример: "task_01KBZ0TZZ7C7M3WS1TJM0PH8J4"

​
Авторизация

​
Authorization
string
обязательно
Все API требуют аутентификации Bearer TokenПолучите API Key на странице управления API ключамиДобавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

​
Ответ

​
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"
  }'
Используйте @username в промпте для ссылки на созданного персонажа (username получается из результатов запроса).