Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6-flash",
    "image_urls": ["https://example.com/photo.jpg"],
    "prompt": "Человек оживает и улыбается",
    "resolution": "1080p",
    "duration": 5,
    "audio": true
  }'

{
  "id": "video_01K2ABJPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "wan2.6-flash",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Ускоренная модель генерации видео Alibaba Cloud Wanxiang Flash
  • Поддержка двух режимов: изображение-в-видео и референсное видео (r2v)
  • Генерация только из текста не поддерживается — необходимо предоставить изображение или URL референсного видео
  • Поддержка разрешений 720p/1080p; наличие/отсутствие аудио влияет на тарификацию
  • Более высокая скорость генерации — идеально для быстрого просмотра и итераций
Изображение или URL референсного видео обязательны: Необходимо предоставить image_urls (изображение-в-видео) или metadata.reference_urls (референсное видео). Запрос только с промптом вернёт ошибку.

​
Логика маршрутизации

Сервер автоматически выбирает модель на основе параметров запроса:
Переданные параметрыРежим
metadata.reference_urls (URL видео)Референсное видео Flash (r2v-flash)
image_urls (изображение)Изображение-в-видео Flash (i2v-flash)
Только prompt❌ Возвращает ошибку

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

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

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

​
model
string
обязательно
Название модели генерации видео, фиксированное значение wan2.6-flash
​
image_urls
string[]
Массив URL референсных изображений (режим изображение-в-видео, только 1 изображение)Обязательно, если не указан metadata.reference_urls⚠️ Только формат URL (base64 больше не поддерживается)
  • Публично доступный URL изображения (http:// или https://)
  • Используйте API загрузки изображений для загрузки локальных изображений
Пример: ["https://example.com/image.jpg"]
​
prompt
string
Описание содержимого видео (опционально)Описывает ожидаемое движение или стиль для направления моделиПример: "Человек оживает и улыбается камере"
​
resolution
string
по умолчанию:"1080p"
Разрешение видеоДоступные значения:
  • 720p - Стандартное
  • 1080p - Высокое качество (по умолчанию)
По умолчанию: 1080pРазные разрешения имеют разную стоимость.
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживается: 5, 10, 15По умолчанию: 5
​
audio
boolean
по умолчанию:"true"
Генерировать видео со звуком
  • true - Видео со звуком (по умолчанию)
  • false - Беззвучное видео
⚠️ Видео со звуком и без тарифицируются по-разному — выбирайте осознанноПо умолчанию: true
​
watermark
boolean
Добавить водяной знак Alibaba Cloud на видео
​
metadata
object
Расширенные параметры

​
Тарификация: со звуком vs без звука

РежимЦена за 720pЦена за 1080p
Со звуком (audio: true)¥0.3 / сек¥0.5 / сек
Без звука (audio: false)¥0.15 / сек¥0.25 / сек

​
Ответ

​
id
string
Уникальный идентификатор задачи
​
object
string
Тип объекта, всегда generation.task
​
model
string
Использованное название модели
​
status
string
Статус задачи
  • queued - В очереди
  • in_progress - Обрабатывается
  • completed - Успешно завершена
  • failed - Ошибка
​
progress
integer
Прогресс задачи в процентах (0-100)
​
created_at
integer
Временная метка создания задачи (Unix timestamp)
​
metadata
object
Метаданные задачи

​
Сценарии использования

​
Сценарий 1: Изображение-в-видео (со звуком)

{
  "model": "wan2.6-flash",
  "image_urls": ["https://example.com/photo.jpg"],
  "prompt": "Человек оживает и улыбается",
  "resolution": "1080p",
  "duration": 5,
  "audio": true
}

​
Сценарий 2: Изображение-в-видео (без звука, экономия)

{
  "model": "wan2.6-flash",
  "image_urls": ["https://example.com/photo.jpg"],
  "resolution": "720p",
  "duration": 5,
  "audio": false
}

​
Сценарий 3: Референсное видео (r2v-flash)

{
  "model": "wan2.6-flash",
  "prompt": "Персонаж смотрит фильм на диване",
  "metadata": {
    "reference_urls": ["https://cdn.example.com/ref-character.mp4"]
  },
  "resolution": "1080p",
  "duration": 5,
  "audio": true
}
Получение результатов задачиГенерация видео — асинхронная задача. После отправки возвращается task_id. Используйте интерфейс Получить статус задачи для запроса прогресса и результатов.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6-flash",
    "image_urls": ["https://example.com/photo.jpg"],
    "prompt": "Человек оживает и улыбается",
    "resolution": "1080p",
    "duration": 5,
    "audio": true
  }'

{
  "id": "video_01K2ABJPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "wan2.6-flash",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}