Перейти к основному содержанию
POST
/
v1
/
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-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

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

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "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-pro — Vidu Q3 Pro
  • viduq3-turbo — Vidu Q3 Turbo
​
prompt
string
обязательно
Текстовый промпт, максимум 2000 символовОбязателен для text-to-video. Опционален для image-to-video и режима «первый и последний кадры».Пример: "A cat playing piano, camera slowly zooms in"
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Диапазон: 1–16По умолчанию: 5
​
resolution
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 540p — стандартное разрешение
  • 720p — HD (по умолчанию)
  • 1080p — Full HD
По умолчанию: 720p
​
aspect_ratio
string
Соотношение сторон видео (только для режима text-to-video)Варианты:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
  • 4:3 — традиционное
  • 3:4 — традиционное портретное
  • 1:1 — квадратное
Этот параметр доступен только в режиме text-to-video (когда image_urls не указан).
​
image_urls
array<url>
Массив URL изображений для генерации image-to-videoСистема автоматически определяет режим генерации по количеству изображений:
  • 0 изображений (не указано): режим text-to-video
  • 1 изображение: режим image-to-video (изображение используется как начальный кадр)
  • 2 изображения: режим «первый и последний кадры» (первое изображение — первый кадр, второе — последний)
Пример: ["https://example.com/photo.jpg"]
  • Поддерживается не более 2 изображений
  • Для режима «первый и последний кадры» должно быть передано ровно 2 изображения
  • Когда image_urls передан (1 или 2 изображения), параметр aspect_ratio использовать нельзя — соотношение сторон видео автоматически определяется по изображению
​
audio
boolean
по умолчанию:"true"
Генерировать ли звук (диалоги, звуковые эффекты)По умолчанию: trueУстановите false, если требуется видео без звука.
​
seed
integer
Целочисленный seed для управления случайностью генерируемого контентаДиапазон: целое число от -1 до 2^32-1
  • При одинаковом запросе разные значения seed (включая не указанное или -1, при которых используется случайное число) дадут разные результаты
  • При одинаковом запросе одинаковое значение seed даст похожие результаты, но точная воспроизводимость не гарантируется

​
Автоматическая маршрутизация

Система автоматически определяет режим генерации по количеству изображений в image_urls:
Количество изображенийРежимОписание
0 (не указано)Text-to-VideoГенерация только из текстового описания
1Image-to-VideoИзображение используется как начальный кадр
2Первый и последний кадрыПервое изображение — первый кадр, второе — последний

​
Матрица поддержки параметров

ПараметрText-to-VideoImage-to-VideoПервый и последний кадры
model✅ Обязательно✅ Обязательно✅ Обязательно
prompt✅ ОбязательноОпциональноОпционально
image_urls-✅ 1 изображение✅ 2 изображения
duration✅ 1–16 с✅ 1–16 с✅ 1–16 с
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
Ответ

​
code
integer
Код состояния ответа, 200 при успехе
​
data
array
Массив данных ответа

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

​
Сценарий 1: Текст в видео

{
  "model": "viduq3-pro",
  "prompt": "A cat playing piano, camera slowly zooms in",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
Сценарий 2: Изображение в видео (одно изображение)

{
  "model": "viduq3-pro",
  "prompt": "The person slowly turns and smiles",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
Сценарий 3: Видео по первому и последнему кадрам

{
  "model": "viduq3-pro",
  "prompt": "The person gradually sits down from standing",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
Сценарий 4: Видео без звука (audio отключён)

{
  "model": "viduq3-pro",
  "prompt": "Sunset seascape timelapse photography",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
Получение результатов задачиГенерация видео — это асинхронная задача, при отправке возвращающая task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты генерации.