Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
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",
    "url": "https://example.com/character-video.mp4",
    "timestamps": "1,3"
  }'

{
  "id": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
  "object": "generation.task",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

​
Обзор

Функция создания персонажей Sora2 позволяет извлекать персонажей из существующих видео. После создания персонаж можно повторно использовать в последующих генерациях видео для сохранения консистентности.
Важно:
  • Видео должно содержать звук и узнаваемого персонажа
  • Ограничение временного диапазона: минимум 1 секунда, максимум 3 секунды
  • Требуется один из параметров: url или from_task
  • Параметр prompt не требуется в этом режиме
  • После создания ID задачи персонажа можно использовать для генерации видео

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

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

​
Параметры запроса

​
model
string
по умолчанию:"sora-2"
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • sora-2 - Стандартная версия
  • sora-2-pro - Профессиональная версия (более высокое качество)
  • sora-2-vip - VIP версия, более высокий приоритет
​
timestamps
string
обязательно
Временной диапазон появления персонажаЕдиница измерения — секунды, формат: "начало,конец"Ограничения:
  • Минимальная разница: 1 секунда
  • Максимальная разница: 3 секунды
Пример: "1,3" означает персонажа с 1-й по 3-ю секунду видео
​
url
string
URL видео с персонажем для извлеченияТребования:
  • Видео должно содержать звук
  • Видео должно содержать узнаваемого персонажа
Примечание: Требуется url или from_taskПример: "https://example.com/my-video.mp4"
​
from_task
string
ID ранее созданной задачи генерации видеоСоздание персонажа из существующей задачиПримечание: Требуется url или from_taskПример: "task_01KBYT59JDHB4A3KDDR9N9JVWP"

​
Поля ответа

​
id
string
Уникальный идентификатор задачи для запроса статуса создания персонажаПосле завершения этот ID можно использовать в генерации видео через параметр character_url
​
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, только после завершения)
​
result
object
Результат создания персонажа (только после завершения)Содержит информацию о персонаже: ID, имя, изображение профиля и т.д.
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",
    "url": "https://example.com/character-video.mp4",
    "timestamps": "1,3"
  }'

{
  "id": "task_01KBYT59JDHB4A3KDDR9N9JVWP",
  "object": "generation.task",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

​
Порядок использования

1

Отправка запроса на создание персонажа

Вызовите API с URL видео или ID существующей задачи, содержащей персонажа, а также временным диапазоном
2

Получение ID задачи

API возвращает ID задачи со статусом queued или in_progress
3

Запрос статуса задачи

Используйте Запрос статуса видео-задачи для отслеживания прогресса
4

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

После завершения создания персонажа используйте параметр character_url для ссылки на ID задачи персонажа

​
Лучшие практики

  1. Выбирайте чёткие сегменты с персонажем: Выбирайте 1-3 секундные сегменты, где черты персонажа наиболее различимы
  2. Обеспечьте качество видео: Видео высокого разрешения позволяет лучше извлекать характеристики персонажа
  3. Включайте звук: Видео должно содержать звуковую дорожку
  4. Избегайте нескольких персонажей: В выбранном временном диапазоне должен быть только один основной персонаж