ToAPIsToAPIs
Sora2

Sora2 VVIP Генерация видео

Генерация высококачественного видео с помощью модели sora-2-vvip

POST
/v1/videos/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

  • Модель генерации видео sora-2-vvip
  • Поддержка текст-в-видео, изображение-в-видео и ссылок на персонажей
  • Асинхронное управление задачами, запрос результатов по ID задачи

Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.

Авторизация

Authorizationstringзаголовокобязательно

Все API требуют аутентификации Bearer Token

Получите API Key на странице управления API ключами

Добавьте в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

Тело запроса

modelstringтелообязательнопо умолчанию: sora-2-vvip

Название модели генерации видео

Поддерживаемая модель: sora-2-vvip - VVIP версия с фиксированными вариантами длительности

Пример: "sora-2-vvip"

promptstringтелообязательно

Текстовое описание для генерации видео

💡 Функция ссылки на персонажей:

Вы можете использовать формат @username в промпте для ссылки на ранее созданных персонажей и включения их в генерируемое видео.

  • username персонажа можно получить через API запроса персонажей
  • Поддерживается одновременная ссылка на несколько персонажей

Пример: "Кошка и собака вместе едут на машине @duksvfkf.cruisingki @zdqwahgj.baronbarki"

durationintegerтело

Длительность видео в секундах

Поддерживает только 4, 8 или 12 секунд

Пример: 4

aspect_ratiostringтело

Соотношение сторон видео

Поддерживаемые форматы:

  • 16:9 (Горизонтальный)
  • 9:16 (Вертикальный)
image_urlsstring[]тело

Массив URL референсных изображений для генерации изображение-в-видео

⚠️ Только формат URL (base64 больше не поддерживается)

  • Публично доступный URL изображения (http:// или https://)
  • Вы можете использовать API загрузки изображений для загрузки локальных изображений и получения URL
thumbnailbooleanтело

Генерировать ли миниатюру видео

  • true - Генерировать миниатюру видео для предварительного просмотра и отображения

Если миниатюра не нужна, можно опустить этот параметр

metadata.nintegerтелопо умолчанию: 1

Количество генерируемых различных вариантов

Диапазон: 1-4

По умолчанию: 1

metadata.watermarkbooleanтелопо умолчанию: false

Добавлять ли водяной знак к генерируемому видео

  • false - Без водяного знака
  • true - Добавить официальный водяной знак Sora к видео

По умолчанию: false

metadata.privatebooleanтелопо умолчанию: false

Включить ли режим конфиденциальности

  • true - Видео не будет опубликовано и не может быть переделано (отредактировано повторно)
  • false - Видео может быть опубликовано и переделано

По умолчанию: false

metadata.stylestringтело

Стиль видео

Поддерживаемые значения:

  • thanksgiving - Стиль День благодарения
  • comic - Комикс стиль
  • news - Новостной стиль
  • selfie - Селфи стиль
  • nostalgic - Ностальгический/Ретро стиль
  • anime - Аниме стиль

Пример: "anime"

metadata.storyboardbooleanтело

Использовать ли раскадровку для более точного контроля деталей генерации видео

  • true - Включить функцию раскадровки
  • false - Не использовать раскадровку

Пример: true

metadata.character_urlstringтело

URL референсного видео для извлечения персонажа

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

Пример: "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4"

⚠️ Примечание: При использовании этого параметра длительность генерируемого видео уменьшится на 1 секунду

metadata.character_timestampsstringтело

Временные метки появления персонажа

Указывает временной диапазон в референсном видео, где появляется персонаж, поддерживает только 2-секундные сегменты

Формат: "начальная_секунда,конечная_секунда"

Пример: "1,3" означает персонажа с 1-й по 3-ю секунду в референсном видео

⚠️ Примечание: При использовании этого параметра длительность генерируемого видео уменьшится на 1 секунду

metadata.character_createbooleanтелопо умолчанию: false

Автоматически создать персонажа из сгенерированного видео после завершения

  • true - Автоматически создать персонажа
  • false - Не создавать персонажа

По умолчанию: false

metadata.character_from_taskstringтело

Создать персонажа из уже сгенерированного ID задачи

Ссылка на ранее сгенерированный ID задачи видео для извлечения персонажей из этого видео

Пример: "video_01K8SGYNNNVBQTXNR4MM964S7K"

Ответ

idstring

Уникальный идентификатор задачи для запроса статуса

objectstring

Тип объекта, всегда generation.task

modelstring

Используемое имя модели

statusstring

Статус задачи

  • queued - В очереди на обработку
  • in_progress - Обработка
  • completed - Успешно завершено
  • failed - Не удалось
progressinteger

Процент выполнения задачи (0-100)

created_atinteger

Временная метка создания задачи (временная метка Unix)

metadataobject

Метаданные задачи

Пример запроса

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "Золотистый ретривер бежит по траве, солнечный день",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "Оживите эту собаку, бегущую по траве",
    "image_urls": ["https://example.com/dog.jpg"],
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "Милый мультяшный слон",
    "aspect_ratio": "16:9",
    "duration": 4,
    "metadata": {
      "style": "anime",
      "watermark": false
    }
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "Маленькая лягушка танцует на ярко освещенной сцене",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-vvip",
    "prompt": "Кошка и собака вместе едут на машине @duksvfkf.cruisingki @zdqwahgj.baronbarki",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "sora-2-vvip",
        "prompt": "Золотистый ретривер бежит по траве, солнечный день",
        "duration": 4,
        "aspect_ratio": "16:9",
        "metadata": {
            "style": "anime",
            "watermark": False,
            "n": 2
        }
    }
)

task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/videos/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'sora-2-vvip',
    prompt: 'Золотистый ретривер бежит по траве, солнечный день',
    duration: 4,
    aspect_ratio: '16:9',
    metadata: {
      style: 'anime',
      watermark: false,
      n: 2
    }
  })
});

const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);

Пример ответа

{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "sora-2-vvip",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "size": "720x720"
  }
}