# Pixverse V6 API Полный справочник API для моделей генерации видео Pixverse V6. Все варианты используют единый endpoint video task. ## Варианты модели | Model | ID | Описание | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Генерирует видео из текстового prompt | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Анимирует из одного начального изображения | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Генерирует переход между начальным и конечным изображениями | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Продлевает существующее видео новыми frames под управлением `prompt` | ## Краткое сравнение | Функция | Text to Video | Image to Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Обязательно | Обязательно | Обязательно | Обязательно | | `aspect_ratio` | Опционально (по умолчанию `16:9`); см. поддерживаемые соотношения ниже | Не используется (следует входному изображению) | Не используется (следует входным изображениям) | Не используется (следует входному видео) | | `image_url` | — | Обязательно | Обязательно (начальное изображение) | — | | `image_end_url` | — | — | Обязательно (конечное изображение) | — | | `video_url` | — | — | — | Обязательно (исходное видео) | | `negative_prompt` | — | — | Опционально | Опционально | | `seed` | — | — | Опционально (`0` считается значением по умолчанию продукта) | Опционально | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | То же | То же | То же | | Audio | Опционально через `sound` | Опционально через `sound` | Опционально через `sound` | Опционально через `sound` | Модели text-to-video поддерживают соотношения сторон: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### Параметры запроса #### Обязательно | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `model_name` | string | Должно быть `"pixverse-v6-text-to-video"` | | `prompt` | string | Prompt для генерации видео | | `duration` | integer | Длина видео в секундах (`1`–`15`) | | `resolution` | string | Один из `360p`, `540p`, `720p`, `1080p` | #### Опционально | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `aspect_ratio` | string | По умолчанию `16:9`. Один из `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Нужно ли генерировать аудио для видео | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-text-to-video', prompt: 'A cinematic street scene at night with neon reflections', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Image to Video ### Параметры запроса #### Обязательно | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `model_name` | string | Должно быть `"pixverse-v6-image-to-video"` | | `prompt` | string | Prompt для генерации видео | | `duration` | integer | Длина видео в секундах (`1`–`15`) | | `resolution` | string | Один из `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL начального изображения | #### Опционально | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `sound` | boolean | Нужно ли генерировать аудио для видео | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-image-to-video', prompt: 'Fluid camera pan; maintain subject identity', duration: 6, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Transition Генерирует движение между **начальным** и **конечным** keyframe-изображениями. Поддерживает опциональные negative prompting и seeding. ### Параметры запроса #### Обязательно | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `model_name` | string | Должно быть `"pixverse-v6-transition"` | | `prompt` | string | Описывает движение между двумя frames | | `duration` | integer | Длина видео в секундах (`1`–`15`) | | `resolution` | string | Один из `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL начального изображения | | `image_end_url` | string | URL конечного изображения | #### Опционально | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `sound` | boolean | Нужно ли генерировать аудио для видео | | `negative_prompt` | string | Контент, которого следует избегать в результате | | `seed` | integer | Seed случайности; `0` использует стандартное случайное поведение платформы | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-transition', prompt: 'Seamless blend with natural lighting continuity', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, negative_prompt: 'blur, watermark, text overlay', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Extend Продолжает существующий клип. Передайте URL исходного видео и prompt, описывающий, как должен развиваться сюжет. ### Параметры запроса #### Обязательно | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `model_name` | string | Должно быть `"pixverse-v6-extend"` | | `prompt` | string | Описывает, как видео должно продолжаться | | `duration` | integer | Длина видео в секундах (`1`–`15`) | | `resolution` | string | Один из `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL исходного видео для продления | #### Опционально | Параметр | Тип | Описание | | --------- | ---- | ----------- | | `sound` | boolean | Нужно ли генерировать аудио для видео | | `negative_prompt` | string | Контент, которого следует избегать в результате | | `seed` | integer | Seed случайности; `0` использует стандартное случайное поведение платформы | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-extend', prompt: 'Continue the walk into the forest clearing', duration: 5, resolution: '720p', video_url: 'https://example.com/source-clip.mp4', sound: false, negative_prompt: 'low quality, jitter', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Формат ответа ### Первичный ответ ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Polling-ответ Опросите `GET /api/v1/video/{taskId}`, чтобы проверить статус: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Значения статуса - `submitted`: Task принят и ожидает обработки - `processing`: Генерация видео выполняется - `succeed`: Генерация видео завершена - `failed`: Генерация видео не удалась ## Рекомендации 1. **Extend**: используйте чистое, стабильное исходное видео, чтобы модель могла продолжить движение без артефактов. 2. **Transition**: сочетайте `negative_prompt` с `seed`, когда нужны повторяемые тесты перехода. 3. **Resolution**: подбирайте `resolution` под целевой результат; более высокие разрешения обрабатываются дольше. 4. **Polling**: опрашивайте каждые 5-10 секунд, пока `task_status` не станет `succeed` или `failed`.