# PixVerse V6 Max

PixVerse V6 Max is the higher-detail version of PixVerse V6. It makes a 1–15 second clip from a prompt, or from one starting image with an optional prompt, at 360p, 540p, 720p or 1080p, with optional native audio. Send the request, keep the returned task ID, and read the finished video from the task. Images go in as URLs.

## Model IDs

| Model ID          | Inputs          | Resolutions                     | Length       |
| ----------------- | --------------- | ------------------------------- | ------------ |
| `pixverse-v6-max` | text, one image | `360p`, `540p`, `720p`, `1080p` | 1–15 seconds |

See the [model page](https://seedrouter.ai/models/pixverse-v6-max#pricing) for current prices. Transitions, multi-image reference and extend are [PixVerse V6](https://seedrouter.ai/docs/pixverse-v6) features.

## Quick example

```bash
curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6-max",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
```

```python
import os
import requests

response = requests.post(
    "https://api.seedrouter.ai/v1/videos/generations",
    headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
    json={
        "model": "pixverse-v6-max",
        "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9",
    },
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
```

```javascript
const response = await fetch('https://api.seedrouter.ai/v1/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SEEDROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'pixverse-v6-max',
    prompt: 'A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9',
  }),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const { id: taskId } = await response.json();
```

```go
package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    body := strings.NewReader(`{
      "model": "pixverse-v6-max",
      "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
      "resolution": "720p",
      "duration": 5,
      "aspect_ratio": "16:9"
    }`)
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/videos/generations", body)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", "Bearer " + os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 60 * time.Second}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    if res.StatusCode != http.StatusOK { panic(res.Status) }
    var task struct { ID string `json:"id"` }
    if err := json.NewDecoder(res.Body).Decode(&task); err != nil { panic(err) }
    fmt.Println(task.ID)
}
```

## Endpoint

```text
POST https://api.seedrouter.ai/v1/videos/generations
```

| Header        | Value                 |
| ------------- | --------------------- |
| Authorization | `Bearer YOUR_API_KEY` |
| Content-Type  | `application/json`    |

The response is a task (`{"id": "task_...", "status": "processing"}`), not the finished video. Poll `GET /v1/tasks/{task_id}` for the result. Keep API keys in server-side code.

## Parameters

| Field          | Type     | Default   | Notes                                                                                                                      |
| -------------- | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
| `model`        | string   | required  | `pixverse-v6-max`                                                                                                          |
| `prompt`       | string   | see notes | Text to video: required, up to 5,000 characters. With an image: optional, up to 2,048 characters.                          |
| `image_urls`   | URL list | none      | Image to video: exactly one image. Without it the clip is text to video.                                                   |
| `resolution`   | enum     | `540p`    | `360p`, `540p`, `720p` or `1080p`.                                                                                         |
| `quality`      | enum     | none      | Alias of `resolution`, same values. `resolution` wins when both are sent.                                                  |
| `duration`     | integer  | `5`       | 1–15 seconds.                                                                                                              |
| `aspect_ratio` | enum     | `16:9`    | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2` or `21:9`. Text to video only; with an image the clip follows the image. |
| `audio`        | boolean  | `false`   | Generate native audio. Billed at the audio rate.                                                                           |
| `seed`         | integer  | none      | 0–2147483647. The same request and seed give similar results.                                                              |

The schema is strict: unknown fields are rejected rather than ignored. `first_frame_image`, `last_frame_image`, `img_references` and `extend_from_task_id` return a 400 that points to `pixverse-v6`. `callback_url` is not available; poll the task instead.

## Image to video

Pass one image in `image_urls`. The clip starts from it and keeps its shape, so a portrait image gives a portrait clip. The prompt is optional here.

```json
{
  "model": "pixverse-v6-max",
  "prompt": "The subject slowly turns toward the camera, soft natural light.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "1080p",
  "duration": 5
}
```

## Media inputs

The image is a public HTTP(S) URL. Base64 data URIs are not accepted: upload the file to your own storage and pass its URL. Use a JPG, PNG or WebP image of 20 MB or less, at most 10,000 pixels on each side.

## Pricing dimensions

Check the [model pricing section](https://seedrouter.ai/models/pixverse-v6-max#pricing) for current rates. PixVerse V6 Max is billed per second of video, at a rate set by the resolution and by whether audio is generated:

```text
cost = duration × rate per second for the resolution and audio setting
```

Text to video and image to video cost the same. The duration is known when the request is accepted, so the amount reserved is the amount charged. View final charges in your account usage history. Failed tasks are not charged.

## Output schema

Submission returns the task:

```json
{"id": "task_...", "model": "pixverse-v6-max", "status": "processing", "created_at": 1789689600}
```

### Get the task

```text
GET https://api.seedrouter.ai/v1/tasks/{task_id}
```

Poll every 10–20 seconds until `status` is `completed` or `failed`. A network timeout while polling does not mean generation failed: keep the task ID and resume checking it. Do not create another task to check progress.

### Completed task

```json
{
  "id": "task_...",
  "model": "pixverse-v6-max",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689690,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}
```

In our tests 1-second `360p` `16:9` clips came back as MP4 (H.264) at 640 × 360, 81–89 seconds after submission.

## Errors

Requests rejected before a task is created return an HTTP error with an `error` object and are not charged. A task that fails after acceptance returns HTTP 200 when queried, with `status: "failed"` and an `error` object.

See the [shared error catalog](https://seedrouter.ai/docs/api/errors) for codes, HTTP statuses, and retry guidance.

```json
{
  "id": "task_...",
  "model": "pixverse-v6-max",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}
```

If submission itself times out, check your tasks before submitting again: the first request may have been accepted.

## Tips

* Describe subject, place, camera move and light in the prompt; name the sounds you want when `audio` is on.
* Draft at `360p` or `540p`, then render the final shot at `1080p` with the same request and `seed`.
* For vertical video, send `aspect_ratio: "9:16"`, or a portrait image.
* Add `no text, no logos` to keep invented marks out.

## Related

* [PixVerse V6 Max Playground and pricing](https://seedrouter.ai/models/pixverse-v6-max)
* [PixVerse V6 API reference](https://seedrouter.ai/docs/pixverse-v6)
* [Download OpenAPI](https://seedrouter.ai/docs/pixverse-v6-max.openapi.json)
* [Copyable Markdown](https://seedrouter.ai/docs/pixverse-v6-max.md)
