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

Comparaison rapide

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

Facultatif

Exemple de requête

javascriptCopier
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

Facultatif

Exemple de requête

javascriptCopier
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

Facultatif

Exemple de requête

javascriptCopier
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

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

jsonCopier
{
  "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"
        }
      ]
    }
  }
}

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.