Перейти к основному содержанию
GET
/
v1
/
characters_tasks
/
{task_id}
curl --request GET \
  --url 'https://toapis.com/v1/characters_tasks/task_01KBZ0TZZ7C7M3WS1TJM0PH8J4' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "task_01KC0JZCMTMQ70D68XTM56Q5D0",
  "object": "generation.task",
  "model": "sora-2",
  "status": "in_progress",
  "progress": 45,
  "created_at": 1765251461,
  "metadata": {}
}

​
Обзор

Запрос статуса и результата задач создания персонажей. Получение подробной информации о созданных персонажах (ID персонажа, отображаемое имя, имя пользователя и т.д.) для использования в последующей генерации видео.
Примечания:
  • Создание персонажа — асинхронная задача, требуется периодический опрос этого API
  • После завершения задачи возвращаются детали персонажа
  • username персонажа можно использовать в промптах в формате @username
  • ID задачи персонажа можно использовать через параметр character_url в генерации видео

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

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

​
Аутентификация

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

​
Поля ответа

​
id
string
Уникальный идентификатор задачи (ID задачи создания персонажа)
​
object
string
Тип объекта, всегда generation.task
​
model
string
Используемая модель
​
status
string
Статус задачи:
  • queued — в очереди
  • in_progress — выполняется
  • completed — успешно завершено
  • failed — ошибка
​
progress
integer
Прогресс выполнения (0-100)
​
created_at
integer
Время создания задачи (Unix timestamp)
​
completed_at
integer
Время завершения задачи (Unix timestamp, только после завершения)
​
expires_at
integer
Время истечения результата (Unix timestamp, только после завершения)
​
result
object
Результат задачи (только когда status = completed)result.type = character, а result.data.characters содержит список персонажей
​
error
object
Ошибка (только когда status = failed)
curl --request GET \
  --url 'https://toapis.com/v1/characters_tasks/task_01KBZ0TZZ7C7M3WS1TJM0PH8J4' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "task_01KC0JZCMTMQ70D68XTM56Q5D0",
  "object": "generation.task",
  "model": "sora-2",
  "status": "in_progress",
  "progress": 45,
  "created_at": 1765251461,
  "metadata": {}
}

​
Использование персонажа в генерации видео

После завершения создания персонажа вы можете использовать его в генерации видео. Есть два способа ссылки:

​
Способ 1: Использование @username в промпте

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "@duksvfkf.turbo_whis is dancing in the rain"
  }'

​
Способ 2: Использование параметра character_url

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "A cute cat is dancing in the rain",
    "character_url": "task_01KC0JZCMTMQ70D68XTM56Q5D0"
  }'
Совет: username получается из поля characters[].username в результатах запроса, character_url использует task_id задачи создания персонажа.

​
Рекомендации по опросу

ПараметрРекомендуемое значение
Интервал опроса5 секунд
Максимальное время ожидания5 минут
Обработка таймаутаПовторная отправка задачи или обращение в поддержку