curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

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

VEO3

VEO3 — генерация видео через официальный канал

Асинхронный режим обработки, возвращает ID задачи для последующих запросов
Поддерживает текст-в-видео и изображение-в-видео (управление первым кадром / первым и последним кадром)
Поддерживает разрешение 720P и 1080P
Поддерживает длительность видео 4/6/8 секунд
Поддерживает генерацию аудиодорожки
Поддерживает управление политикой генерации людей

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": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "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": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

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

Авторизация

Authorization

string

обязательно

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

Authorization: Bearer YOUR_API_KEY

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

model

string

обязательно

Имя модели генерации видеоДоступные модели:

veo3.1-fast-official — Veo 3.1 Official Fast
veo3.1-quality-official — Veo 3.1 Official High Quality

prompt

string

обязательно

Положительный текстовый промптПодробно описывайте сцены, действия, стили и так далее для лучших результатов генерации. Рекомендуется использовать промпты на английском языке.Пример: "a golden retriever running on the beach, sunset, cinematic"

negative_prompt

string

Негативный промпт для исключения нежелательного содержимогоПример: "blurry, low quality, watermark, text"

duration

integer

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

Длительность видео в секундахРекомендуемые значения: 4 / 6 / 8По умолчанию: 8Примечание: должно быть целым числом (например, 8), не добавляйте кавычки, иначе возникнет ошибка

aspect_ratio

string

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

Соотношение сторон видеоДоступные значения:

16:9 — горизонтальное
9:16 — вертикальное

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

resolution

string

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

Разрешение видеоДоступные значения:

720p — стандартное разрешение
1080p — высокое разрешение
4K — сверхвысокое разрешение

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

first_frame_image

string

URL изображения первого кадра для генерации изображение-в-видео

URL изображения должен быть публично доступен без защиты от хотлинкинга
Рекомендуется использовать URL объектного хранилища, а не временные ссылки на загрузку

last_frame_image

string

URL изображения последнего кадра для генерации изображение-в-видеоИспользуется вместе с first_frame_image для управления первым и последним кадрами

seed

integer

Случайное seed-значение для воспроизведения результатов генерацииДиапазон значений: 0 — 4294967295

sample_count

integer

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

Количество генерируемых сэмплов (1-4), в настоящее время рекомендуется использовать 1По умолчанию: 1

generate_audio

boolean

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

Генерировать ли аудиодорожку

person_generation

string

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

Политика генерации людейДоступные значения:

allow_adult — разрешать генерацию только взрослых людей/лиц
disallow — не разрешать генерацию людей или лиц

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

resize_mode

string

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

Стратегия изменения размера изображения (действует для изображение-в-видео)Доступные значения:

pad — режим добавления полей
crop — режим обрезки

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

enhance_prompt

boolean

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

Включать ли улучшение промпта на стороне провайдераПо умолчанию: true

Этот параметр можно установить только в true. Значение false приведёт к ошибке запроса
Если этот параметр не нужен, не включайте его

Текст-в-видео и изображение-в-видео

Система автоматически определяет режим в зависимости от того, передаются ли параметры с изображениями: без изображений — текст-в-видео, с изображениями — изображение-в-видео.

Параметр	Текст-в-видео	Изображение-в-видео
`prompt`	Обязательный	Обязательный
`first_frame_image`	Не используется	Обязательный (хотя бы один)
`last_frame_image`	Не используется	Необязательный (последний кадр)
`negative_prompt`	Необязательный	Необязательный
`duration`	Необязательный	Необязательный
`aspect_ratio`	Необязательный	Необязательный
`resolution`	Необязательный	Необязательный
`seed`	Необязательный	Необязательный
`generate_audio`	Необязательный	Необязательный
`person_generation`	Необязательный	Необязательный
`resize_mode`	Не применяется	Необязательный
`enhance_prompt`	Необязательный	Необязательный

Ответ

code

integer

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

data

array

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

Показать Свойства

status

string

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

task_id

string

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

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

Сценарий 1: текст-в-видео (базовый)

{
  "model": "veo3.1-fast-official",
  "prompt": "a golden retriever running on the beach, sunset, cinematic"
}

Сценарий 2: текст-в-видео (полный набор параметров)

{
  "model": "veo3.1-quality-official",
  "prompt": "a cinematic close-up of a ragdoll cat slowly walking through a sunlit living room",
  "negative_prompt": "blurry, low quality, watermark, text",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "seed": 12345,
  "generate_audio": true,
  "person_generation": "disallow",
  "enhance_prompt": true
}

Сценарий 3: изображение-в-видео (один первый кадр)

{
  "model": "veo3.1-fast-official",
  "prompt": "the cat slowly walks forward and looks around",
  "first_frame_image": "https://example.com/cat.png",
  "duration": 8,
  "resolution": "720p"
}

Сценарий 4: изображение-в-видео (первый и последний кадр)

{
  "model": "veo3.1-quality-official",
  "prompt": "smooth cinematic transition from the first frame to the last frame",
  "first_frame_image": "https://example.com/frame-start.png",
  "last_frame_image": "https://example.com/frame-end.png",
  "duration": 8,
  "resolution": "1080p"
}

Сценарий 5: видео со звуком

{
  "model": "veo3.1-quality-official",
  "prompt": "a busy coffee shop with people chatting and barista making latte art",
  "duration": 8,
  "generate_audio": true,
  "aspect_ratio": "16:9"
}

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

VEO3 — продление видео MiniMax-Hailuo-02 — генерация видео

Documentation Index

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

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

​Текст-в-видео и изображение-в-видео

​Ответ

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

​Сценарий 1: текст-в-видео (базовый)

​Сценарий 2: текст-в-видео (полный набор параметров)

​Сценарий 3: изображение-в-видео (один первый кадр)

​Сценарий 4: изображение-в-видео (первый и последний кадр)

​Сценарий 5: видео со звуком

Авторизация

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

Текст-в-видео и изображение-в-видео

Ответ

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

Сценарий 1: текст-в-видео (базовый)

Сценарий 2: текст-в-видео (полный набор параметров)

Сценарий 3: изображение-в-видео (один первый кадр)

Сценарий 4: изображение-в-видео (первый и последний кадр)

Сценарий 5: видео со звуком