> ## 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.

# PixVerse V6 Max Генерация видео

> Генерация видео по тексту и одному изображению в 360p / 540p / 720p / 1080p, длительностью 1–15 секунд, с необязательным нативным звуком.

> [!NOTE]
>
> Этот эндпоинт работает асинхронно. После отправки используйте полученный `task_id` в `GET /v1/videos/generations/{task_id}`, чтобы узнать статус и результат задачи.

```bash cURL theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "pixverse-v6-max",
    "prompt": "A blue glass marble rolls across a clean white table in morning light",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "pixverse-v6-max",
        "prompt": "A blue glass marble rolls across a clean white table in morning light",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": True
    }
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "pixverse-v6-max",
    prompt: "A blue glass marble rolls across a clean white table in morning light",
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    audio: true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

## Возможности модели

PixVerse V6 Max — версия PixVerse V6 с повышенным качеством изображения. Поддерживается только генерация по тексту и одному изображению, в обоих случаях с именем модели `pixverse-v6-max`.

| Режим | Входные данные | Соотношение сторон |
| - | - | - |
| Генерация по тексту | Не передавайте `image_urls`; `prompt` обязателен | Используется `aspect_ratio`, по умолчанию `16:9` |
| Генерация по изображению | Передайте 1 изображение в `image_urls`; `prompt` необязателен | Следует за входным изображением; `aspect_ratio` не действует |

Для переходов между первым и последним кадрами, объединения нескольких изображений и продления видео используйте [PixVerse V6](/ru/api-reference/videos/pixverse-v6/generation.md).

## Заголовки запроса

**Authorization** `string` *required*

Аутентификация Bearer: `Bearer <token>`, где `<token>` — ваш API-ключ APIMart.

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

**model** `string` *required*

Должно быть `pixverse-v6-max`.

**prompt** `string`

Описание содержимого для генерации. Обязательно при генерации по тексту, до 5000 символов; необязательно при генерации по изображению, до 2048 символов.

**image\_urls** `string[]`

Список URL входных изображений. Генерация по изображению принимает ровно 1 изображение; передача 2 и более синхронно возвращает HTTP 400. Для генерации по тексту не передавайте это поле.

Изображение должно быть общедоступно по HTTP(S), в формате JPEG, PNG или WebP, размером менее 20 MB, с длиной каждой стороны не более 10000 пикселей.

**duration** `integer` (default: 5)

Длительность результата в секундах: от `1` до `15`, по умолчанию `5`.

**resolution** `string` (default: 540p)

Разрешение результата: `360p`, `540p`, `720p` или `1080p`; по умолчанию `540p`.

Результат использует нативные размеры модели поставщика; ориентируйтесь на фактически возвращённые размеры. Примеры, наблюдавшиеся в тестах: `640×360` и `1108×832` (ширина × высота, в пикселях).

Также принимается поле `quality`. Если переданы оба поля, приоритет у `resolution`.

**quality** `string`

Поле совместимости для разрешения с теми же значениями, что у `resolution`. Используется только при отсутствии `resolution`; если оба поля не заданы, применяется `540p`.

**aspect\_ratio** `string` (default: 16:9)

Действует только при генерации по тексту. Поддерживаются `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` и `21:9`; по умолчанию `16:9`.

При генерации по изображению всегда используется его соотношение сторон; это поле не действует.

**audio** `boolean` (default: false)

Укажите `true` для генерации нативного звука; по умолчанию видео без звука. Генерация со звуком имеет более высокую цену за секунду.

Учитывается только `audio` на верхнем уровне тела запроса. `metadata.generate_audio_switch` не включает звук и не активирует тариф со звуком.

**seed** `integer`

Случайное зерно в диапазоне от `0` до `2147483647`.

## Пример генерации по изображению

```json theme={null}
{
  "model": "pixverse-v6-max",
  "prompt": "Make the subject walk forward slowly",
  "image_urls": ["https://example.com/start.png"],
  "duration": 5,
  "resolution": "1080p"
}
```

Замените пример URL реальным общедоступным адресом изображения. Передайте только 1 изображение; соотношение сторон результата будет соответствовать ему.

## Запрос состояния задачи

Замените ID задачи в следующем запросе на `task_id`, полученный при отправке:

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/videos/generations/<task_id>' \
  --header 'Authorization: Bearer <token>'
```

## Оплата

Стоимость равна длительности результата в секундах, умноженной на цену за секунду для выбранных разрешения и настройки звука. Для генерации со звуком и без него действуют отдельные тарифы; со звуком цена за секунду выше.

Если не заданы ни `resolution`, ни `quality`, для результата и оплаты используется `540p`.

Актуальные цены возвращает [эндпоинт цен модели](https://api.apimart.ai/api/pricing/model?model=pixverse-v6-max):

| Настройка звука | Поле цены |
| - | - |
| Без звука | Цена соответствующего разрешения в `resolution_paid_prices` |
| Со звуком | Соответствующий уровень `<resolution>-audio` в `billing_tier_paid_prices` |

## Неподдерживаемые функции и ошибки параметров

Следующие запросы синхронно возвращают HTTP 400, без создания задачи и списания средств:

| Запрос | Сообщение об ошибке |
| - | - |
| Содержит `extend_from_task_id` | `pixverse-v6-max does not support video extend …; use pixverse-v6 instead` |
| Содержит `img_references` | `pixverse-v6-max does not support multi-image reference …` |
| Содержит `first_frame_image` или `last_frame_image` | `pixverse-v6-max does not support first/last frame transition …` |
| В `image_urls` передано 2 изображения или более | `pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N)` |
| `resolution` не входит в 4 поддерживаемых уровня | `invalid resolution …` |
| `duration` превышает 15 секунд | `invalid duration …` |
| При генерации по тексту `aspect_ratio` не входит в 8 поддерживаемых соотношений | `invalid aspect_ratio …` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.