# PixVerse V6 Max

Старшая PixVerse V6: видео от 1 до 15 секунд вплоть до 1080p, по тексту или от первого кадра, со звуком по желанию.

## Обзор

- **Modality:** Видео
- **Modes:** Текст → Видео, Картинка → Видео
- **Страница модели:** https://iskragen.ru/models/pixverse-v6-max
- **`modelSlug` для API:** `pixverse-v6-max-text-to-video`, `pixverse-v6-max-image-to-video`

## Стоимость

- Базовая цена: 5–378 ₽ за `second`

| Тариф | Цена | Примечание |
| --- | --- | --- |
| 1 секунда | 5 ₽ |  |
| минимум 1 секунда | 5 ₽ |  |
| максимум 15 секунд | 75 ₽ |  |

**Включено:**
- 360p, 540p, 720p или 1080p
- Звук по желанию
- Text-to-video и image-to-video

## Сценарии и параметры

### Текст → Видео

- Mode ID: `text-to-video`
- `modelSlug` для API: `pixverse-v6-max-text-to-video`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `duration` | select | `5` | `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` | Длина видео от 1 до 15 секунд. Цена растёт посекундно. |
| `quality` | select | `720p` | `360p`, `540p`, `720p`, `1080p` |  |
| `generate_audio_switch` | select | `false` | `false`, `true` | Звук, синхронный с видео. |
| `seed` | number | — | 0–2147483647 | Случайное зерно. Один и тот же seed + промпт = воспроизводимый результат. |
| `aspect_ratio` | select | `16:9` | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` |  |

### Картинка → Видео

- Mode ID: `image-to-video`
- `modelSlug` для API: `pixverse-v6-max-image-to-video`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `duration` | select | `5` | `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` | Длина видео от 1 до 15 секунд. Цена растёт посекундно. |
| `quality` | select | `720p` | `360p`, `540p`, `720p`, `1080p` |  |
| `generate_audio_switch` | select | `false` | `false`, `true` | Звук, синхронный с видео. |
| `seed` | number | — | 0–2147483647 | Случайное зерно. Один и тот же seed + промпт = воспроизводимый результат. |
| `image_urls` | file-list | [] | image[], до 1 шт, 20 МБ | Видео начнётся с этого кадра; формат ролика берётся из фото. Стороны до 10 000 px. |

## Использование через API

Полный цикл интеграции: API-ключ → создание генерации → polling → результат. Базовый URL: `https://api.iskragen.ru/v1`.

### 1. Получите API-ключ

Личный кабинет → «API-ключи» (https://iskragen.ru/api-keys). Значение показывается один раз. Ключ передаётся в заголовке каждого запроса:

```
Authorization: Bearer iskr_live_<secret>
```

### 2. Создайте генерацию

```bash
curl -X POST https://api.iskragen.ru/v1/generations \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "modelSlug": "pixverse-v6-max-text-to-video",
  "prompt": "Опишите, что вы хотите сгенерировать",
  "params": {
    "duration": "5",
    "quality": "720p",
    "generate_audio_switch": "false"
  }
}'
```

У каждого сценария свой `modelSlug` — возьмите значение из раздела «Сценарии и параметры» выше.

Генерация асинхронная: ответ — `202 Accepted`, задача ставится в очередь, стоимость удерживается с баланса.

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "PENDING",
  "costRub": 5
}
```

### 3. Дождитесь результата (polling)

Опрашивайте `GET /v1/generations/{id}` раз в ~2 секунды, пока `status` не станет `SUCCEEDED` или `FAILED`:

```bash
curl https://api.iskragen.ru/v1/generations/$GENERATION_ID \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY"
```

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "SUCCEEDED",
  "outputUrls": ["https://s3.twcstorage.ru/.../result.webp"],
  "costRub": 5,
  "errorCode": null,
  "errorMessage": null
}
```

- `outputUrls` — ссылки на готовые файлы; заполняются при `SUCCEEDED`.
- При `FAILED` средства возвращаются на баланс автоматически, причина — в `errorCode` / `errorMessage`.
- Лимит: 5 одновременных генераций (`PENDING` + `PROCESSING`), при превышении — `429`.
- Для длинных задач (видео, музыка) вместо polling'а используйте [Webhooks](https://iskragen.ru/docs/webhooks.md).

### Полная документация

- Generations API (все поля, image-to-image, ошибки): https://iskragen.ru/docs/api-generations.md
- Аутентификация: https://iskragen.ru/docs/authentication.md
- Ошибки: https://iskragen.ru/docs/errors.md
- Лимиты: https://iskragen.ru/docs/rate-limits.md
- Индекс всей документации для LLM: https://iskragen.ru/llms.txt
- Машиночитаемый каталог моделей (slug, params, цены): https://api.iskragen.ru/v1/catalog