Sora2 Создание персонажа

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": {}
}

POST

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"

Поля ответа

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": {}
}

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

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

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

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

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

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

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

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

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

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

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

Sora2 VVIP Запрос статуса персонажа

​Обзор

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

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

​Поля ответа

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

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

Обзор

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

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

Поля ответа

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

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