API de FLUX 3

Referencia completa de la API para los modelos de generación de vídeo FLUX 3. Todas las variantes utilizan el endpoint unificado de tareas de vídeo.

Variantes del modelo

Comparación rápida

Los cuatro modelos admiten estas relaciones de aspecto:

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

Punto de conexión

POST /api/v1/video/task

Autenticación

Authorization: Bearer YOUR_API_KEY

FLUX 3 de texto a vídeo

Parámetros de la solicitud

Obligatorios

Opcionales

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: '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 de imagen a vídeo

Parámetros de la solicitud

Obligatorios

Opcionales

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: '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 de inicio-fin a vídeo

Parámetros de la solicitud

Obligatorios

Opcionales

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: '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;

Extensión de vídeo FLUX 3

El vídeo de entrada debe utilizar el formato MP4, no superar los 15 segundos y no ocupar más de 50 MB.

Parámetros de la solicitud

Obligatorios

Opcionales

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: '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;

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 consulta

Consulta GET /api/v1/video/{task_id} para comprobar el estado de la tarea:

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
• processing: Generación del vídeo en curso
• succeed: Generación del vídeo completada correctamente
• failed: Error en la generación del vídeo

Prácticas recomendadas

1. Relación de aspecto: Elige la relación para el canal de destino antes de enviar la tarea.
2. Duración: Utiliza un valor de 5 a 20 segundos para cada variante.
3. Medios de entrada: Utiliza URL de imágenes accesibles y una fuente MP4 que cumpla los límites de extensión de vídeo.
4. Consulta: Consulta el estado cada 5–10 segundos hasta que task_status sea succeed o failed.