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

> Text-zu-Video und Video aus einem einzelnen Bild in 360p / 540p / 720p / 1080p, mit 1–15 Sekunden Dauer und optionalem nativem Ton.

> [!NOTE]
>
> Dieser Endpunkt arbeitet asynchron. Verwenden Sie nach dem Absenden die zurückgegebene `task_id` mit `GET /v1/videos/generations/{task_id}`, um Status und Ergebnis abzufragen.

```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());
```

## Modellfunktionen

PixVerse V6 Max ist die Version von PixVerse V6 mit höherer Bildqualität. Unterstützt werden nur Text-zu-Video und Video aus einem einzelnen Bild, jeweils mit dem Modellnamen `pixverse-v6-max`.

| Modus | Eingabe | Seitenverhältnis |
| - | - | - |
| Text-zu-Video | `image_urls` weglassen; `prompt` ist erforderlich | Verwendet `aspect_ratio`, standardmäßig `16:9` |
| Bild-zu-Video | 1 Bild in `image_urls` übergeben; `prompt` ist optional | Folgt dem Eingabebild; `aspect_ratio` hat keine Wirkung |

Für Übergänge zwischen Start- und Endbild, die Kombination mehrerer Bilder und Videoverlängerung verwenden Sie [PixVerse V6](/de/api-reference/videos/pixverse-v6/generation.md).

## Anfrage-Header

**Authorization** `string` *required*

Bearer-Authentifizierung: `Bearer <token>`, wobei `<token>` Ihr APIMart API Key ist.

## Anfrageparameter

**model** `string` *required*

Muss `pixverse-v6-max` sein.

**prompt** `string`

Beschreibung des zu generierenden Inhalts. Für Text-zu-Video erforderlich, maximal 5000 Zeichen; für Bild-zu-Video optional, maximal 2048 Zeichen.

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

Liste der Eingabebild-URLs. Bild-zu-Video akzeptiert genau 1 Bild; bei 2 oder mehr wird synchron HTTP 400 zurückgegeben. Für Text-zu-Video das Feld weglassen.

Bilder müssen über HTTP(S) öffentlich erreichbar sein, im Format JPEG, PNG oder WebP vorliegen, kleiner als 20 MB sein und dürfen pro Seite maximal 10000 Pixel haben.

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

Ausgabedauer in Sekunden: `1`–`15`, Standardwert `5`.

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

Ausgabeauflösung: `360p`, `540p`, `720p` oder `1080p`; Standardwert `540p`.

Die Ausgabe verwendet die nativen Abmessungen des zugrunde liegenden Modells. Maßgeblich sind die tatsächlich zurückgegebenen Abmessungen. Beispiele aus Tests sind `640×360` und `1108×832` (Breite × Höhe in Pixeln).

Auch `quality` wird akzeptiert. Wenn beide Felder angegeben sind, hat `resolution` Vorrang.

**quality** `string`

Kompatibilitätsfeld für die Auflösung mit denselben Werten wie `resolution`. Wird nur ohne `resolution` verwendet; fehlen beide Felder, gilt `540p`.

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

Gilt nur für Text-zu-Video. Unterstützt `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` und `21:9`; Standardwert `16:9`.

Bild-zu-Video folgt immer dem Seitenverhältnis des Eingabebilds; dieses Feld hat keine Wirkung.

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

`true` aktiviert die native Tonerzeugung; standardmäßig ist das Video stumm. Mit Ton gilt ein höherer Preis pro Sekunde.

Nur `audio` auf der obersten Ebene des Anfragekörpers wird ausgewertet. `metadata.generate_audio_switch` aktiviert weder Ton noch den Audiotarif.

**seed** `integer`

Zufallsstartwert von `0` bis `2147483647`.

## Beispiel für Bild-zu-Video

```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"
}
```

Ersetzen Sie die Beispiel-URL durch eine echte, öffentlich erreichbare Bild-URL. Übergeben Sie nur 1 Bild; das Seitenverhältnis der Ausgabe folgt diesem Bild.

## Aufgabe abfragen

Ersetzen Sie die Aufgaben-ID in der folgenden Anfrage durch die beim Absenden zurückgegebene `task_id`:

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

## Abrechnung

Die Kosten ergeben sich aus Ausgabesekunden mal Sekundenpreis für die gewählte Auflösung und Audiostufe. Für Videos mit und ohne Ton gelten separate Preise; mit Ton ist der Sekundenpreis höher.

Wenn weder `resolution` noch `quality` angegeben wird, verwenden Ausgabe und Abrechnung `540p`.

Aktuelle Preise liefert der [Endpunkt für Modellpreise](https://api.apimart.ai/api/pricing/model?model=pixverse-v6-max):

| Audiostufe | Preisfeld |
| - | - |
| Ohne Ton | Preis der jeweiligen Auflösung in `resolution_paid_prices` |
| Mit Ton | Passende Stufe `<resolution>-audio` in `billing_tier_paid_prices` |

## Nicht unterstützte Funktionen und Parameterfehler

Die folgenden Anfragen liefern synchron HTTP 400, ohne eine Aufgabe zu erstellen oder Kosten zu berechnen:

| Anfrage | Fehlermeldung |
| - | - |
| Enthält `extend_from_task_id` | `pixverse-v6-max does not support video extend …; use pixverse-v6 instead` |
| Enthält `img_references` | `pixverse-v6-max does not support multi-image reference …` |
| Enthält `first_frame_image` oder `last_frame_image` | `pixverse-v6-max does not support first/last frame transition …` |
| 2 oder mehr Bilder in `image_urls` | `pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N)` |
| `resolution` ist keine der 4 unterstützten Stufen | `invalid resolution …` |
| `duration` überschreitet 15 Sekunden | `invalid duration …` |
| `aspect_ratio` bei Text-zu-Video ist keines der 8 unterstützten Verhältnisse | `invalid aspect_ratio …` |


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