API FLUX 3

Référence complète de l'API pour les modèles de génération vidéo FLUX 3. Toutes les variantes utilisent le point de terminaison unifié des tâches vidéo.

Variantes du modèle

Comparaison rapide

Les quatre modèles prennent en charge les rapports d'aspect suivants :

21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16

Point de terminaison

POST /api/v1/video/task

Authentification

Authorization: Bearer YOUR_API_KEY

FLUX 3 texte vers vidéo

Paramètres de la requête

Obligatoires

Facultatifs

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: 'flux-3.0-text-to-video',
    prompt: 'A cinematic aerial shot of a coastal city at sunrise',
    resolution: '1080p',
    aspect_ratio: '16:9',
    duration: 10,
    sound: true,
  }),
});

const { data } = await response.json();
const taskId = data.task_id;

FLUX 3 image vers vidéo

Paramètres de la requête

Obligatoires

Facultatifs

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: 'flux-3.0-image-to-video',
    prompt: 'A gentle camera push forward with natural subject motion',
    resolution: '1080p',
    aspect_ratio: '16:9',
    image_url: 'https://example.com/first-frame.jpg',
    duration: 10,
    sound: true,
  }),
});

const { data } = await response.json();
const taskId = data.task_id;

FLUX 3 début-fin vers vidéo

Paramètres de la requête

Obligatoires

Facultatifs

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: 'flux-3.0-start-end-to-video',
    prompt: 'Create a smooth cinematic transition with consistent lighting',
    resolution: '720p',
    aspect_ratio: '16:9',
    image_url: 'https://example.com/start-frame.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    duration: 8,
    sound: true,
  }),
});

const { data } = await response.json();
const taskId = data.task_id;

Extension vidéo FLUX 3

La vidéo d'entrée doit être au format MP4, ne pas dépasser 15 secondes et ne pas excéder 50 Mo.

Paramètres de la requête

Obligatoires

Facultatifs

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: 'flux-3.0-video-extend',
    prompt: 'Continue the scene as the subject walks toward the skyline',
    resolution: '1080p',
    aspect_ratio: '16:9',
    video_url: 'https://example.com/source-video.mp4',
    duration: 10,
    sound: true,
  }),
});

const { data } = await response.json();
const taskId = data.task_id;

Format de la 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 d'interrogation

Interrogez GET /api/v1/video/{task_id} pour vérifier l'état de la tâche :

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 d'état

• submitted : Tâche acceptée
• processing : Génération de la vidéo en cours
• succeed : Génération de la vidéo terminée avec succès
• failed : Échec de la génération de la vidéo

Bonnes pratiques

1. Rapport d'aspect : Choisissez le rapport adapté au canal cible avant d'envoyer la tâche.
2. Durée : Utilisez une valeur comprise entre 5 et 20 secondes pour chaque variante.
3. Médias d'entrée : Utilisez des URL d'images accessibles et une source MP4 respectant les limites de l'extension vidéo.
4. Interrogation : Interrogez l'état toutes les 5 à 10 secondes jusqu'à ce que task_status soit succeed ou failed.