Перейти к основному содержанию
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": "pixverse-v6",
    "prompt": "A cinematic shot of a corgi running through a sunflower field at golden hour",
    "size": "16:9",
    "resolution": "540p",
    "duration": 5
  }'

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

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": "pixverse-v6",
    "prompt": "A cinematic shot of a corgi running through a sunflower field at golden hour",
    "size": "16:9",
    "resolution": "540p",
    "duration": 5
  }'

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

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

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

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

​
model
string
обязательно
Название модели генерации видео. Фиксировано: pixverse-v6.
​
prompt
string
обязательно
Описание содержимого видео, до 5000 символов. Обязателен во всех режимах.
​
resolution
string
по умолчанию:"540p"
Разрешение видео. Влияет на стоимость.
  • 360p: SD
  • 540p: Стандарт (по умолчанию)
  • 720p: HD
  • 1080p: Full HD
Другие значения разрешения возвращают ошибку параметра.
​
duration
integer
по умолчанию:"5"
Длительность видео в секундах, диапазон 1–15.
Режим перехода между первым и последним кадрами поддерживает только 5 или 8 секунд.
​
size
string
по умолчанию:"16:9"
Соотношение сторон видео. Действует только в режимах «текст в видео» и объединения нескольких опорных изображений.
  • 16:9: Горизонтальный широкий (по умолчанию)
  • 4:3: Горизонтальный 4:3
  • 1:1: Квадрат
  • 3:4: Вертикальный 3:4
  • 9:16: Вертикальный
  • 2:3: Вертикальный 2:3
  • 3:2: Горизонтальный 3:2
  • 21:9: Кинематографический широкий
​
seed
integer
по умолчанию:"0"
Случайное зерно. Диапазон 0–2147483647. Один и тот же prompt и seed дают похожий результат.
​
negative_prompt
string
Негативный промпт для исключения нежелательного содержимого. До 2048 символов.
​
audio
boolean
по умолчанию:"false"
Генерировать ли аудиодорожку.
  • true: Генерировать аудио (повышает цену)
  • false: Без аудио (по умолчанию)
​
watermark
boolean
по умолчанию:"false"
Добавлять ли водяной знак в правом нижнем углу видео.
  • true: Добавить водяной знак
  • false: Без водяного знака (по умолчанию)
​
motion_mode
string
Режим движения.
  • normal: Стандартный режим (pixverse-v6 поддерживает только это значение)
fast доступен только для устаревших моделей и будет отклонён сервером для pixverse-v6.
​
generate_multi_clip_switch
boolean
по умолчанию:"false"
Генерировать ли непрерывное видео из нескольких клипов. Поддерживается только в режимах «текст в видео» и «изображение в видео».
  • true: Генерировать непрерывное многоклиповое видео
  • false: Один клип (по умолчанию)
​
image_urls
array<url>
Массив URL входных изображений для режима «изображение в видео». Используется только первое изображение.Изображения должны быть публично доступными HTTP/HTTPS URL.
​
first_frame_image
url
URL первого кадра в режиме перехода. Должен передаваться вместе с last_frame_image.
​
last_frame_image
url
URL последнего кадра в режиме перехода. Должен передаваться вместе с first_frame_image.
​
img_references
array<url>
Массив URL опорных изображений для режима объединения. Поддерживает 1–7 изображений.Передача этого поля активирует режим объединения нескольких опорных изображений.
​
extend_from_task_id
string
ID исходной задачи для продолжения видео. Передача этого поля активирует режим продолжения.Исходная задача должна принадлежать текущему пользователю, иметь модель pixverse-v6 и статус completed.

​
Режимы генерации

Адаптер автоматически выбирает режим генерации по полям запроса. Сопоставление выполняется по приоритету: побеждает первый совпавший режим.
РежимУсловие активацииОписание
Текст в видеоПоля изображения и продолжения отсутствуютГенерация видео по prompt
Изображение в видеоimage_urls с одним изображениемИспользуется первое изображение
Переход между первым и последним кадрамиУказаны и first_frame_image, и last_frame_imageГенерация плавного перехода между двумя кадрами
Объединение нескольких опорных изображенийУказан массив img_referencesОбъединение 1–7 изображений в видео
Продолжение видеоУказан extend_from_task_idПродолжение из завершённой задачи Pixverse
Все входы изображений принимают только публично доступные HTTP/HTTPS URL. base64 и Data URI не поддерживаются. Если у вас есть только локальные изображения, сначала загрузите их в объектное хранилище и передайте URL.

​
Правила параметров

ОграничениеОписание
Длительность1 ≤ duration ≤ 15 секунд; режим перехода поддерживает только 5 или 8 секунд
РазрешениеПоддерживаются только 360p, 540p, 720p, 1080p
Соотношение сторонsize действует только в режимах «текст в видео» и объединения опорных изображений
Длина промптаprompt до 5000 символов, negative_prompt до 2048 символов
Изображение в видеоimage_urls использует только первое изображение
Переходfirst_frame_image и last_frame_image передаются парой
Режим движенияpixverse-v6 поддерживает только normal
Объединение опорных изображенийimg_references поддерживает 1–7 изображений
Продолжение видеоextend_from_task_id должен указывать на завершённую (completed) задачу pixverse-v6 текущего пользователя

​
Ответ

​
code
integer
Код состояния ответа. При успехе — 200.
​
data
array
Возвращаемый массив задач.

​
Получение результата задачи

Генерация видео — асинхронная задача. После отправки возвращается task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата.
cURL
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01JWXXXXXXXXXXXX \
  --header 'Authorization: Bearer <token>'
Рекомендуется опрашивать каждые 5 секунд, пока статус не станет completed или failed.

​
Пример успешного результата

{
  "code": 200,
  "data": {
    "id": "task_01KSPX48B8V1M6C2ZN0D0T4BKB",
    "status": "completed",
    "progress": 100,
    "cost": 0.2,
    "created": 1779958948,
    "completed": 1779958999,
    "estimated_time": 100,
    "actual_time": 51,
    "result": {
      "videos": [
        {
          "url": ["https://upload.apimart.ai/f/video/xxxx.mp4"],
          "expires_at": 1780045399
        }
      ]
    }
  }
}
URL видео находится по пути data.result.videos[0].url[0]. Поле url само является массивом. Ссылки обычно действуют 24 часа — заранее скачайте или перенесите файл.

​
Пример неудачного результата

{
  "code": 200,
  "data": {
    "id": "task_01KSPX48B8V1M6C2ZN0D0T4BKB",
    "status": "failed",
    "progress": 100,
    "cost": 0,
    "created": 1779958948,
    "completed": 1779958960,
    "error": {
      "code": "task_failed",
      "message": "pixverse error 400063: moderation failed",
      "type": "task_failed"
    }
  }
}
При неудаче cost обычно равен 0. Причина ошибки — в data.error.message.

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

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

{
  "model": "pixverse-v6",
  "prompt": "A neon-lit alley in Tokyo at night, light rain, anamorphic lens flare",
  "size": "21:9",
  "resolution": "720p",
  "duration": 8,
  "seed": 42,
  "audio": true
}

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

{
  "model": "pixverse-v6",
  "prompt": "Camera slowly zooms in, gentle wind moves the leaves",
  "image_urls": ["https://example.com/first-frame.jpg"],
  "resolution": "540p",
  "duration": 5
}

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

{
  "model": "pixverse-v6",
  "prompt": "transform smoothly from a puppy to a cat",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/cat.jpg",
  "resolution": "540p",
  "duration": 5,
  "motion_mode": "normal"
}

​
Сценарий 4: Объединение нескольких опорных изображений

{
  "model": "pixverse-v6",
  "prompt": "A girl wearing the outfit from image 2, holding the cat from image 3",
  "img_references": [
    "https://example.com/character.jpg",
    "https://example.com/outfit.jpg",
    "https://example.com/cat.jpg"
  ],
  "size": "9:16",
  "resolution": "720p",
  "duration": 5
}

​
Сценарий 5: Продолжение видео

{
  "model": "pixverse-v6",
  "prompt": "the character now walks into a forest",
  "extend_from_task_id": "task_01JWXXXXXXXXXXXX",
  "resolution": "540p",
  "duration": 5
}