# Pixverse V6 API Référence API complète pour les modèles de génération vidéo Pixverse V6. Toutes les variantes utilisent le point de terminaison unifié des tâches vidéo. ## Variantes du modèle | Model | ID | Description | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Générer une vidéo à partir d’un prompt texte | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Animer à partir d’une seule image initiale | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Générer une transition entre une image initiale et une image finale | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Étendre une vidéo existante avec de nouvelles frames guidées par `prompt` | ## Comparaison rapide | Fonctionnalité | Texte vers vidéo | Image vers vidéo | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Requis | Requis | Requis | Requis | | `aspect_ratio` | Facultatif (par défaut `16:9`) ; voir les ratios pris en charge ci-dessous | Non utilisé (suit l’image d’entrée) | Non utilisé (suit les images d’entrée) | Non utilisé (suit la vidéo d’entrée) | | `image_url` | — | Requis | Requis (image initiale) | — | | `image_end_url` | — | — | Requis (image finale) | — | | `video_url` | — | — | — | Requis (vidéo source) | | `negative_prompt` | — | — | Facultatif | Facultatif | | `seed` | — | — | Facultatif (`0` est traité comme les valeurs par défaut du produit) | Facultatif | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Identique | Identique | Identique | | Audio | Facultatif via `sound` | Facultatif via `sound` | Facultatif via `sound` | Facultatif via `sound` | Les modèles text-to-video prennent en charge les ratios : `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### Point de terminaison ``` POST /api/v1/video/task ``` ### Paramètres de requête #### Requis | Paramètre | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Doit être `"pixverse-v6-text-to-video"` | | `prompt` | string | Prompt de génération vidéo | | `duration` | integer | Durée de la vidéo en secondes (`1`–`15`) | | `resolution` | string | L’un de `360p`, `540p`, `720p`, `1080p` | #### Facultatif | Paramètre | Type | Description | | --------- | ---- | ----------- | | `aspect_ratio` | string | Par défaut `16:9`. L’un de `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Indique s’il faut générer de l’audio pour la vidéo | ### Exemple de requête ```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 ### Paramètres de requête #### Requis | Paramètre | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Doit être `"pixverse-v6-image-to-video"` | | `prompt` | string | Prompt de génération vidéo | | `duration` | integer | Durée de la vidéo en secondes (`1`–`15`) | | `resolution` | string | L’un de `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL de l’image initiale | #### Facultatif | Paramètre | Type | Description | | --------- | ---- | ----------- | | `sound` | boolean | Indique s’il faut générer de l’audio pour la vidéo | ### Exemple de requête ```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 Génère un mouvement entre une image clé **initiale** et **finale**. Prend en charge le negative prompting et le seeding facultatifs. ### Paramètres de requête #### Requis | Paramètre | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Doit être `"pixverse-v6-transition"` | | `prompt` | string | Décrit le mouvement entre les deux frames | | `duration` | integer | Durée de la vidéo en secondes (`1`–`15`) | | `resolution` | string | L’un de `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL de l’image initiale | | `image_end_url` | string | URL de l’image finale | #### Facultatif | Paramètre | Type | Description | | --------- | ---- | ----------- | | `sound` | boolean | Indique s’il faut générer de l’audio pour la vidéo | | `negative_prompt` | string | Contenu à décourager dans la sortie | | `seed` | integer | Seed d’aléa ; `0` suit le comportement aléatoire par défaut de la plateforme | ### Exemple de requête ```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 Continue un clip existant. Fournissez l’URL de la vidéo source et un prompt décrivant la progression de l’histoire. ### Paramètres de requête #### Requis | Paramètre | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Doit être `"pixverse-v6-extend"` | | `prompt` | string | Décrit comment la vidéo doit continuer | | `duration` | integer | Durée de la vidéo en secondes (`1`–`15`) | | `resolution` | string | L’un de `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL de la vidéo source à étendre | #### Facultatif | Paramètre | Type | Description | | --------- | ---- | ----------- | | `sound` | boolean | Indique s’il faut générer de l’audio pour la vidéo | | `negative_prompt` | string | Contenu à décourager dans la sortie | | `seed` | integer | Seed d’aléa ; `0` suit le comportement aléatoire par défaut de la plateforme | ### Exemple de requête ```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; ``` ## Format de réponse ### Réponse initiale ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Réponse de polling Interrogez `GET /api/v1/video/{taskId}` pour vérifier le statut : ```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" } ] } } } ``` ### Valeurs de statut - `submitted`: Tâche acceptée et en attente de traitement - `processing`: Génération vidéo en cours - `succeed`: Génération vidéo terminée - `failed`: Échec de la génération vidéo ## Bonnes pratiques 1. **Extend** : utilisez une vidéo source propre et stable afin que le modèle puisse prolonger le mouvement sans artefacts. 2. **Transition** : associez `negative_prompt` à `seed` lorsque vous avez besoin de tests de transition reproductibles. 3. **Resolution** : adaptez `resolution` à votre cible de livraison ; les résolutions plus élevées prennent plus de temps à traiter. 4. **Polling** : interrogez toutes les 5 à 10 secondes jusqu’à ce que `task_status` soit `succeed` ou `failed`.