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

Comparación rápida

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

Opcional

Ejemplo de solicitud

javascriptCopiar
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

Opcional

Ejemplo de solicitud

javascriptCopiar
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

Opcional

Ejemplo de solicitud

javascriptCopiar
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

jsonCopiar
{
  "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:

jsonCopiar
{
  "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": {
      "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.