# Pixverse C1 API Référence API complète pour les modèles de génération vidéo Pixverse C1. Toutes les variantes utilisent le point de terminaison unifié des tâches vidéo. ## Variantes du modèle | Model | ID | Description | | ----- | --- | ----------- | | **Pixverse C1 Text to Video** | `pixverse-c1-text-to-video` | Générer une vidéo à partir d’un prompt texte | | **Pixverse C1 Image to Video** | `pixverse-c1-image-to-video` | Animer à partir d’une seule image initiale | | **Pixverse C1 Transition** | `pixverse-c1-transition` | Générer une transition entre une image initiale et une image finale | ## Comparaison rapide | Fonctionnalité | Texte vers vidéo | Image vers vidéo | Transition | | ------- | ------------- | -------------- | ---------- | | `prompt` | 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) | | `image_url` | — | Requis | Requis (image initiale) | | `image_end_url` | — | — | Requis (image finale) | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Identique | Identique | | Audio | 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 C1 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-c1-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-c1-text-to-video', prompt: 'A drone shot over coastline at golden hour', duration: 5, resolution: '720p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Image to Video ### Paramètres de requête #### Requis | Paramètre | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Doit être `"pixverse-c1-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-c1-image-to-video', prompt: 'Slow zoom in; soft natural motion', duration: 5, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: false, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Transition Génère un mouvement entre une image clé **initiale** et **finale**. ### Paramètres de requête #### Requis | Paramètre | Type | Description | | --------- | ---- | ----------- | | `model_name` | string | Doit être `"pixverse-c1-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 | ### 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-c1-transition', prompt: 'Smooth cinematic morph between the two scenes', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, }), }); 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. **Resolution** : utilisez `720p` ou `1080p` pour équilibrer qualité et temps de génération ; utilisez `360p` ou `540p` pour itérer plus vite. 2. **Transitions** : utilisez des premières et dernières frames nettes et bien éclairées afin que le modèle interpole le mouvement de façon fiable. 3. **Audio** : définissez `sound` si vous voulez un audio ambiant synchronisé ; omettez-le ou définissez `false` pour une sortie muette. 4. **Polling** : interrogez toutes les 5 à 10 secondes jusqu’à ce que `task_status` soit `succeed` ou `failed`.