# Pixverse V6 API Vollständige API-Referenz für Pixverse V6 Videoerzeugungsmodelle. Alle Varianten verwenden den einheitlichen Video-Task-Endpunkt. ## Modellvarianten | Model | ID | Beschreibung | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Video aus einem Textprompt erzeugen | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Aus einem einzelnen Startbild animieren | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Eine Transition zwischen einem Startbild und einem Endbild erzeugen | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Ein vorhandenes Video mit neuen, durch `prompt` gesteuerten Frames erweitern | ## Schnellvergleich | Funktion | Text zu Video | Bild zu Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Erforderlich | Erforderlich | Erforderlich | Erforderlich | | `aspect_ratio` | Optional (Standard `16:9`); siehe unterstützte Seitenverhältnisse unten | Nicht verwendet (folgt dem Eingabebild) | Nicht verwendet (folgt den Eingabebildern) | Nicht verwendet (folgt dem Eingabevideo) | | `image_url` | — | Erforderlich | Erforderlich (Startbild) | — | | `image_end_url` | — | — | Erforderlich (Endbild) | — | | `video_url` | — | — | — | Erforderlich (Quellvideo) | | `negative_prompt` | — | — | Optional | Optional | | `seed` | — | — | Optional (`0` wird wie Produktstandard behandelt) | Optional | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Gleich | Gleich | Gleich | | Audio | Optional über `sound` | Optional über `sound` | Optional über `sound` | Optional über `sound` | Text-to-video-Modelle unterstützen die Seitenverhältnisse: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### Endpunkt ``` POST /api/v1/video/task ``` ### Request-Parameter #### Erforderlich | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `model_name` | string | Muss `"pixverse-v6-text-to-video"` sein | | `prompt` | string | Prompt für die Videoerzeugung | | `duration` | integer | Videolänge in Sekunden (`1`–`15`) | | `resolution` | string | Einer von `360p`, `540p`, `720p`, `1080p` | #### Optional | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `aspect_ratio` | string | Standard `16:9`. Einer von `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Ob Audio für das Video erzeugt werden soll | ### Beispiel-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-Parameter #### Erforderlich | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `model_name` | string | Muss `"pixverse-v6-image-to-video"` sein | | `prompt` | string | Prompt für die Videoerzeugung | | `duration` | integer | Videolänge in Sekunden (`1`–`15`) | | `resolution` | string | Einer von `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL des Startbildes | #### Optional | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `sound` | boolean | Ob Audio für das Video erzeugt werden soll | ### Beispiel-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 Erzeugt Bewegung zwischen einem **ersten** und **letzten** Keyframe-Bild. Unterstützt optionales negative prompting und seeding. ### Request-Parameter #### Erforderlich | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `model_name` | string | Muss `"pixverse-v6-transition"` sein | | `prompt` | string | Beschreibt die Bewegung zwischen den beiden Frames | | `duration` | integer | Videolänge in Sekunden (`1`–`15`) | | `resolution` | string | Einer von `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL des Startbildes | | `image_end_url` | string | URL des Endbildes | #### Optional | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `sound` | boolean | Ob Audio für das Video erzeugt werden soll | | `negative_prompt` | string | Inhalte, die im Output vermieden werden sollen | | `seed` | integer | Zufalls-Seed; `0` folgt dem standardmäßigen Zufallsverhalten der Plattform | ### Beispiel-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 Setzt einen vorhandenen Clip fort. Gib die Quellvideo-URL und einen Prompt an, der beschreibt, wie die Geschichte weitergehen soll. ### Request-Parameter #### Erforderlich | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `model_name` | string | Muss `"pixverse-v6-extend"` sein | | `prompt` | string | Beschreibt, wie das Video fortgesetzt werden soll | | `duration` | integer | Videolänge in Sekunden (`1`–`15`) | | `resolution` | string | Einer von `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL des zu erweiternden Quellvideos | #### Optional | Parameter | Typ | Beschreibung | | --------- | ---- | ----------- | | `sound` | boolean | Ob Audio für das Video erzeugt werden soll | | `negative_prompt` | string | Inhalte, die im Output vermieden werden sollen | | `seed` | integer | Zufalls-Seed; `0` folgt dem standardmäßigen Zufallsverhalten der Plattform | ### Beispiel-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 Frage `GET /api/v1/video/{taskId}` ab, um den Status zu prüfen: ```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" } ] } } } ``` ### Statuswerte - `submitted`: Task angenommen und wartet auf Verarbeitung - `processing`: Videoerzeugung läuft - `succeed`: Videoerzeugung abgeschlossen - `failed`: Videoerzeugung fehlgeschlagen ## Best Practices 1. **Extend**: Verwende ein sauberes, stabiles Quellvideo, damit das Modell Bewegung ohne Artefakte fortsetzen kann. 2. **Transition**: Kombiniere `negative_prompt` mit `seed`, wenn du wiederholbare Transition-Tests brauchst. 3. **Resolution**: Passe `resolution` an dein Auslieferungsziel an; höhere Auflösungen brauchen länger. 4. **Polling**: Frage alle 5–10 Sekunden ab, bis `task_status` `succeed` oder `failed` ist.