# Pixverse V6 API Riferimento API completo per i modelli di generazione video Pixverse V6. Tutte le varianti usano l’endpoint unificato per i task video. ## Varianti del modello | Model | ID | Descrizione | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Genera video da un prompt testuale | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Anima partendo da una singola immagine iniziale | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Genera una transizione tra un’immagine iniziale e una finale | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Estende un video esistente con nuovi frame guidati da `prompt` | ## Confronto rapido | Funzionalità | Da testo a video | Da immagine a video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Obbligatorio | Obbligatorio | Obbligatorio | Obbligatorio | | `aspect_ratio` | Facoltativo (predefinito `16:9`); vedi i rapporti supportati sotto | Non usato (segue l’immagine di input) | Non usato (segue le immagini di input) | Non usato (segue il video di input) | | `image_url` | — | Obbligatorio | Obbligatorio (frame iniziale) | — | | `image_end_url` | — | — | Obbligatorio (frame finale) | — | | `video_url` | — | — | — | Obbligatorio (video sorgente) | | `negative_prompt` | — | — | Facoltativo | Facoltativo | | `seed` | — | — | Facoltativo (`0` è trattato come impostazione predefinita del prodotto) | Facoltativo | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Uguale | Uguale | Uguale | | Audio | Facoltativo tramite `sound` | Facoltativo tramite `sound` | Facoltativo tramite `sound` | Facoltativo tramite `sound` | I modelli text-to-video supportano i rapporti: `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 ``` ### Parametri della richiesta #### Obbligatorio | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `model_name` | string | Deve essere `"pixverse-v6-text-to-video"` | | `prompt` | string | Prompt di generazione video | | `duration` | integer | Durata del video in secondi (`1`–`15`) | | `resolution` | string | Uno tra `360p`, `540p`, `720p`, `1080p` | #### Facoltativo | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `aspect_ratio` | string | Predefinito `16:9`. Uno tra `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Se generare audio per il video | ### Esempio di richiesta ```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 ### Parametri della richiesta #### Obbligatorio | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `model_name` | string | Deve essere `"pixverse-v6-image-to-video"` | | `prompt` | string | Prompt di generazione video | | `duration` | integer | Durata del video in secondi (`1`–`15`) | | `resolution` | string | Uno tra `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL dell’immagine iniziale | #### Facoltativo | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `sound` | boolean | Se generare audio per il video | ### Esempio di richiesta ```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 Genera movimento tra un’immagine keyframe **iniziale** e **finale**. Supporta negative prompting e seeding facoltativi. ### Parametri della richiesta #### Obbligatorio | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `model_name` | string | Deve essere `"pixverse-v6-transition"` | | `prompt` | string | Descrive il movimento tra i due frame | | `duration` | integer | Durata del video in secondi (`1`–`15`) | | `resolution` | string | Uno tra `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL dell’immagine iniziale | | `image_end_url` | string | URL dell’immagine finale | #### Facoltativo | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `sound` | boolean | Se generare audio per il video | | `negative_prompt` | string | Contenuto da scoraggiare nell’output | | `seed` | integer | Seed di casualità; `0` segue il comportamento casuale predefinito della piattaforma | ### Esempio di richiesta ```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 Continua una clip esistente. Fornisci l’URL del video sorgente e un prompt che descriva come la storia dovrebbe proseguire. ### Parametri della richiesta #### Obbligatorio | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `model_name` | string | Deve essere `"pixverse-v6-extend"` | | `prompt` | string | Descrive come il video deve continuare | | `duration` | integer | Durata del video in secondi (`1`–`15`) | | `resolution` | string | Uno tra `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL del video sorgente da estendere | #### Facoltativo | Parametro | Tipo | Descrizione | | --------- | ---- | ----------- | | `sound` | boolean | Se generare audio per il video | | `negative_prompt` | string | Contenuto da scoraggiare nell’output | | `seed` | integer | Seed di casualità; `0` segue il comportamento casuale predefinito della piattaforma | ### Esempio di richiesta ```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; ``` ## Formato della risposta ### Risposta iniziale ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Risposta di polling Interroga `GET /api/v1/video/{taskId}` per controllare lo stato: ```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" } ] } } } ``` ### Valori di stato - `submitted`: Task accettato e in attesa di elaborazione - `processing`: Generazione video in corso - `succeed`: Generazione video completata - `failed`: Generazione video non riuscita ## Best practice 1. **Extend**: usa un video sorgente pulito e stabile affinché il modello possa continuare il movimento senza artefatti. 2. **Transition**: abbina `negative_prompt` a `seed` quando servono test di transizione ripetibili. 3. **Resolution**: adatta `resolution` al target di consegna; le risoluzioni più alte richiedono più tempo. 4. **Polling**: interroga ogni 5–10 secondi finché `task_status` non è `succeed` o `failed`.