API de Flux Kontext Max

Referencia completa de la API para Flux Kontext Max con comprensión mejorada de contexto multiimagen.

Descripción general del modelo

Comparación rápida

Relaciones de aspecto admitidas

Ambos modos admiten 9 relaciones de aspecto:

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

Costo

Flux Kontext Max (texto a imagen)

Punto de conexión

POST /api/v1/image/task

Autenticación

Authorization: Bearer YOUR_API_KEY

Parámetros de solicitud

Obligatorios

Nota: La relación width:height debe ser una de: "1:1", "16:9", "9:16", "3:2", "2:3", "4:3", "3:4", "21:9", "9:21"

Solicitud de ejemplo

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'flux-kontext-max',
    prompt: 'A futuristic cityscape at night with neon lights',
    width: 16,
    height: 9
  })
});

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

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

Flux Kontext Max (imagen a imagen)

Punto de conexión

POST /api/v1/image/task

Parámetros de solicitud

Obligatorios

Nota: La relación width:height debe ser una de: "1:1", "16:9", "9:16", "3:2", "2:3", "4:3", "3:4", "21:9", "9:21"

Ejemplo de edición de una sola imagen

javascriptCopiar
{
  model_name: 'flux-kontext-max',
  prompt: 'Enhance this portrait with cinematic lighting',
  width: 3,
  height: 4,
  image_url_list: ['https://example.com/portrait.jpg']
}

Ejemplo de composición multiimagen

javascriptCopiar
{
  model_name: 'flux-kontext-max',
  prompt: 'Merge these architectural photos into a unified panorama',
  width: 21,
  height: 9,
  image_url_list: ['https://example.com/arch1.jpg', 'https://example.com/arch2.jpg', 'https://example.com/arch3.jpg']
}

Formato de respuesta

Respuesta inicial

Ambos modos devuelven un task_id para consultar el resultado:

jsonCopiar
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "submitted",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
  },
  "message": "success"
}

Respuesta de consulta

Consulta /api/v1/image/{taskId} para comprobar el estado:

jsonCopiar
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 0.08,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

Valores de estado

• submitted: Tarea aceptada
• processing: Generación en curso
• succeed: Generación completada correctamente
• failed: La generación falló

Manejo de errores

Errores comunes

Relación de aspecto no válida

jsonCopiar
{
  "code": 400,
  "message": "Ratio must be one of: 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 21:9, 9:21"
}

Falta URL de imagen (modo imagen a imagen)

jsonCopiar
{
  "code": 400,
  "message": "image_url_list is required for flux-kontext-max"
}

Demasiadas imágenes

jsonCopiar
{
  "code": 400,
  "message": "Maximum 5 images allowed"
}

Buenas prácticas

Consejos para texto a imagen

1. Prompts detallados: Proporciona descripciones claras y detalladas para obtener los mejores resultados
2. Relación de aspecto: Elige una relación de aspecto adecuada para tu caso de uso
3. Escenas complejas: Flux Kontext Max destaca en escenas complejas y detalladas
4. Consulta eficiente: Comprueba el estado cada 2-3 segundos

Consejos para imagen a imagen

1. Consciente del contexto: Aprovecha la entrada multiimagen para una generación rica en contexto
2. Entrada de alta calidad: Usa imágenes fuente de alta resolución para obtener los mejores resultados
3. Objetivos de transformación claros: Describe con precisión el resultado deseado
4. Sinergia multiimagen: Combina hasta 5 imágenes para composiciones complejas

Casos de uso de ejemplo

Fotografía de producto de alta gama

javascriptCopiar
{
  model_name: 'flux-kontext-max',
  prompt: 'Ultra-realistic product shot of diamond jewelry on black velvet',
  width: 4,
  height: 3
}

Visualización arquitectónica

javascriptCopiar
{
  model_name: 'flux-kontext-max',
  prompt: 'Modern minimalist interior with natural lighting',
  width: 16,
  height: 9
}

Panorama multiimagen

javascriptCopiar
{
  model_name: 'flux-kontext-max',
  image_url_list: ['view1.jpg', 'view2.jpg', 'view3.jpg', 'view4.jpg'],
  prompt: 'Seamless 360-degree panorama of mountain landscape',
  width: 21,
  height: 9
}

Transferencia avanzada de estilo

javascriptCopiar
{
  model_name: 'flux-kontext-max',
  image_url_list: ['photo.jpg'],
  prompt: 'Transform into oil painting with Van Gogh style brushwork',
  width: 1,
  height: 1
}