Skip to main content
POST

Обзор

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

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

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

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

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

Поля ответа

string
Уникальный идентификатор задачи для запроса статуса создания персонажаПосле завершения этот ID можно использовать в генерации видео через параметр character_url
string
Тип объекта, всегда generation.task
string
Использованная модель
string
Статус задачи:
  • queued - В очереди на обработку
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
integer
Прогресс выполнения задачи в процентах (0-100)
integer
Время создания задачи (Unix timestamp)
integer
Время завершения задачи (Unix timestamp, только после завершения)
object
Результат создания персонажа (только после завершения)Содержит информацию о персонаже: ID, имя, изображение профиля и т.д.

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

1

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

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

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

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

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

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

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

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

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

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