curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Vidu Q3(mix/standard)

Vidu Q3 (mix/standard) — генерация видео по референсам

Асинхронный режим обработки, возвращает идентификатор задачи для последующих запросов
Загрузка 1–7 референсных изображений + текстовый промпт для генерации коротких видео с референсными субъектами
Поддерживает разрешения 540p / 720p / 1080p
Диапазон длительности 1–16 секунд, подходит для сохранения консистентности персонажей и продолжения стиля

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Авторизация

Authorization

string

обязательно

Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключДобавьте его в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

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

model

string

обязательно

Название модели генерации видеоПоддерживаемые модели:

viduq3-mix — премиум-качество, более сильные интеллектуальные переходы, поддерживает 1-секундные короткие видео
viduq3 — выбор по умолчанию, более интеллектуальное переключение ракурсов

Как выбрать: используйте viduq3 для повседневных задач; используйте viduq3-mix для премиум-качества или эффектов движения 1–2 секунды.

prompt

string

обязательно

Текстовый промпт, максимум 5000 символовОписывайте действия и движения камеры, а не внешний вид (внешний вид определяется референсными изображениями).Пример: "Santa Claus and the bear hug by the lakeside"

image_urls

array<url>

обязательно

Массив URL референсных изображений, 1–7 изображенийПоддерживает публично доступные URL изображений (http:// или https://)Пример: ["https://example.com/santa.png", "https://example.com/bear.png"]

Количество: 1–7 изображений
Поддерживаемые форматы: PNG, JPEG, JPG, WebP
Минимальный размер: 128×128
Соотношение сторон: от 1:4 до 4:1
Максимальный размер файла: ≤ 50 МБ на изображение
Должны быть публично доступными URL

duration

integer

по умолчанию:"5"

Длительность видео (секунды)

viduq3-mix: 1–16
viduq3: 3–16

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

viduq3 поддерживает минимум 3 секунды, viduq3-mix — минимум 1 секунду. Передавайте корректную длительность в зависимости от выбранной модели.

resolution

string

по умолчанию:"720p"

Разрешение видео

viduq3-mix: 720p (по умолчанию) / 1080p
viduq3: 540p / 720p (по умолчанию) / 1080p

viduq3-mix не поддерживает 540p, используйте 720p или 1080p.

aspect_ratio

string

по умолчанию:"16:9"

Соотношение сторон видеоВарианты:

16:9 — горизонтальное (по умолчанию)
9:16 — вертикальное
4:3 — традиционное
3:4 — традиционное портретное
1:1 — квадратное

seed

integer

Случайный seed для управления случайностью генерацииЕсли не указан, будет использован случайный seed.

Использование одного и того же seed с идентичными параметрами даст похожие результаты, но не гарантирует полную идентичность.

Сравнение моделей

Характеристика	`viduq3`	`viduq3-mix`
Рекомендовано для	Повседневное использование, многоракурсное переключение камеры	Премиум-качество, эффекты движения 1–2 секунды
Диапазон длительности	3–16 секунд	1–16 секунд
Разрешение	540p / 720p / 1080p	720p / 1080p
Референсные изображения	1–7 изображений	1–7 изображений

Ответ

code

integer

Код состояния ответа, 200 при успехе

data

array

Массив данных ответа

Показать Элементы массива

status

string

Статус задачи, submitted при первоначальной отправке

task_id

string

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

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

Сценарий 1: базовая генерация по референсам viduq3

{
  "model": "viduq3",
  "prompt": "Santa Claus and the bear hug by the lakeside",
  "image_urls": [
    "https://example.com/santa.png",
    "https://example.com/bear.png"
  ]
}

Сценарий 2: viduq3-mix — генерация по референсам с высоким качеством

{
  "model": "viduq3-mix",
  "prompt": "A cyberpunk neon street with the cat from reference image walking by",
  "image_urls": [
    "https://example.com/cat-1.png",
    "https://example.com/cat-2.png",
    "https://example.com/cat-3.png"
  ],
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "seed": 42
}

Получение результатов задачиГенерация видео — это асинхронная задача, при отправке возвращающая task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты генерации.

Генерация видео Vidu Q3 (pro/turbo)Генерация видео Grok Imagine 1.0

Documentation Index

​Авторизация

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

​Сравнение моделей

​Ответ

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

​Сценарий 1: базовая генерация по референсам viduq3

​Сценарий 2: viduq3-mix — генерация по референсам с высоким качеством

Авторизация

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

Сравнение моделей

Ответ

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

Сценарий 1: базовая генерация по референсам viduq3

Сценарий 2: viduq3-mix — генерация по референсам с высоким качеством