# Pixverse C1 API Referencia completa de la API para los modelos de generación de video Pixverse C1. Todas las variantes usan el endpoint unificado de tareas de video. ## Variantes del modelo | Model | ID | Descripción | | ----- | --- | ----------- | | **Pixverse C1 Text to Video** | `pixverse-c1-text-to-video` | Generar video desde un prompt de texto | | **Pixverse C1 Image to Video** | `pixverse-c1-image-to-video` | Animar desde una sola imagen inicial | | **Pixverse C1 Transition** | `pixverse-c1-transition` | Generar una transición entre una imagen inicial y una final | ## Comparación rápida | Función | Texto a video | Imagen a video | Transición | | ------- | ------------- | -------------- | ---------- | | `prompt` | Obligatorio | Obligatorio | Obligatorio | | `aspect_ratio` | Opcional (predeterminado `16:9`); consulta las relaciones compatibles abajo | No se usa (sigue la imagen de entrada) | No se usa (sigue las imágenes de entrada) | | `image_url` | — | Obligatorio | Obligatorio (imagen inicial) | | `image_end_url` | — | — | Obligatorio (imagen final) | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Igual | Igual | | Audio | Opcional mediante `sound` | Opcional mediante `sound` | Opcional mediante `sound` | Los modelos text-to-video admiten las relaciones de aspecto: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse C1 Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### Parámetros de solicitud #### Obligatorio | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `model_name` | string | Debe ser `"pixverse-c1-text-to-video"` | | `prompt` | string | Prompt de generación de video | | `duration` | integer | Duración del video en segundos (`1`–`15`) | | `resolution` | string | Uno de `360p`, `540p`, `720p`, `1080p` | #### Opcional | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `aspect_ratio` | string | Predeterminado `16:9`. Uno de `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Si se debe generar audio para el video | ### Ejemplo de solicitud ```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 ### Parámetros de solicitud #### Obligatorio | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `model_name` | string | Debe ser `"pixverse-c1-image-to-video"` | | `prompt` | string | Prompt de generación de video | | `duration` | integer | Duración del video en segundos (`1`–`15`) | | `resolution` | string | Uno de `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL de la imagen inicial | #### Opcional | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `sound` | boolean | Si se debe generar audio para el video | ### Ejemplo de solicitud ```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 Genera movimiento entre una imagen keyframe **inicial** y **final**. ### Parámetros de solicitud #### Obligatorio | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `model_name` | string | Debe ser `"pixverse-c1-transition"` | | `prompt` | string | Describe el movimiento entre los dos frames | | `duration` | integer | Duración del video en segundos (`1`–`15`) | | `resolution` | string | Uno de `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL de la imagen inicial | | `image_end_url` | string | URL de la imagen final | #### Opcional | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `sound` | boolean | Si se debe generar audio para el video | ### Ejemplo de solicitud ```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; ``` ## Formato de respuesta ### Respuesta inicial ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Respuesta de polling Consulta `GET /api/v1/video/{taskId}` para comprobar el estado: ```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" } ] } } } ``` ### Valores de estado - `submitted`: Tarea aceptada y en espera de procesamiento - `processing`: Generación de video en curso - `succeed`: Generación de video completada - `failed`: Generación de video fallida ## Buenas prácticas 1. **Resolution**: usa `720p` o `1080p` para equilibrar calidad y tiempo de generación; usa `360p` o `540p` para iterar más rápido. 2. **Transitions**: usa primeros y últimos frames nítidos y bien iluminados para que el modelo pueda interpolar el movimiento con fiabilidad. 3. **Audio**: define `sound` cuando quieras audio ambiental sincronizado; omítelo o define `false` para una salida silenciosa. 4. **Polling**: consulta cada 5–10 segundos hasta que `task_status` sea `succeed` o `failed`.