# Pixverse V6 API Complete API reference for Pixverse V6 video generation models. All variants use the unified video task endpoint. ## Model Variants | Model | ID | Description | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Generate video from a text prompt | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Animate from a single first-frame image | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Generate a transition between a first-frame and last-frame image | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Extend an existing video with new frames guided by `prompt` | ## Quick Comparison | Feature | Text to Video | Image to Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Required | Required | Required | Required | | `aspect_ratio` | Optional (default `16:9`); see supported ratios below | Not used (follows input image) | Not used (follows input images) | Not used (follows input video) | | `image_url` | — | Required | Required (first frame) | — | | `image_end_url` | — | — | Required (last frame) | — | | `video_url` | — | — | — | Required (source video) | | `negative_prompt` | — | — | Optional | Optional | | `seed` | — | — | Optional (`0` treated as in product defaults) | Optional | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Same | Same | Same | | Audio | Optional via `sound` | Optional via `sound` | Optional via `sound` | Optional via `sound` | Text-to-video models support aspect ratios: `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 ``` ### Request Parameters #### Required | Parameter | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Must be `"pixverse-v6-text-to-video"` | | `prompt` | string | Video generation prompt | | `duration` | integer | Video length in seconds (`1`–`15`) | | `resolution` | string | One of `360p`, `540p`, `720p`, `1080p` | #### Optional | Parameter | Type | Description | | --------- | ---- | ----------- | | `aspect_ratio` | string | Default `16:9`. One of `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Whether to generate audio for the video | ### Example Request ```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 ### Request Parameters #### Required | Parameter | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Must be `"pixverse-v6-image-to-video"` | | `prompt` | string | Video generation prompt | | `duration` | integer | Video length in seconds (`1`–`15`) | | `resolution` | string | One of `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL of the first-frame image | #### Optional | Parameter | Type | Description | | --------- | ---- | ----------- | | `sound` | boolean | Whether to generate audio for the video | ### Example Request ```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 Generates motion between a **first** and **last** keyframe image. Supports optional negative prompting and seeding. ### Request Parameters #### Required | Parameter | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Must be `"pixverse-v6-transition"` | | `prompt` | string | Describes the motion between the two frames | | `duration` | integer | Video length in seconds (`1`–`15`) | | `resolution` | string | One of `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL of the first-frame image | | `image_end_url` | string | URL of the last-frame image | #### Optional | Parameter | Type | Description | | --------- | ---- | ----------- | | `sound` | boolean | Whether to generate audio for the video | | `negative_prompt` | string | Content to discourage in the output | | `seed` | integer | Randomness seed; `0` follows platform default random behavior | ### Example Request ```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 Continues an existing clip. Provide the source video URL and a prompt that describes how the story should progress. ### Request Parameters #### Required | Parameter | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Must be `"pixverse-v6-extend"` | | `prompt` | string | Describes how the video should continue | | `duration` | integer | Video length in seconds (`1`–`15`) | | `resolution` | string | One of `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL of the source video to extend | #### Optional | Parameter | Type | Description | | --------- | ---- | ----------- | | `sound` | boolean | Whether to generate audio for the video | | `negative_prompt` | string | Content to discourage in the output | | `seed` | integer | Randomness seed; `0` follows platform default random behavior | ### Example Request ```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; ``` ## Response Format ### Initial Response ```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 Response Poll `GET /api/v1/video/{taskId}` to check status: ```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" } ] } } } ``` ### Status Values - `submitted`: Task accepted and waiting to be processed - `processing`: Video generation in progress - `succeed`: Video generation completed - `failed`: Video generation failed ## Best Practices 1. **Extend**: Use a clean, stable source video so the model can continue motion without artifacts. 2. **Transition**: Pair `negative_prompt` with `seed` when you need repeatable transition tests. 3. **Resolution**: Match `resolution` to your delivery target; higher resolutions take longer to process. 4. **Polling**: Poll every 5–10 seconds until `task_status` is `succeed` or `failed`.