API de Flux Kontext Pro

Referencia completa de la API para Flux Kontext Pro con comprensión 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 Pro (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-pro',
    prompt: 'A serene mountain landscape at sunset',
    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 Pro (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-pro',
  prompt: 'Transform this photo into a watercolor painting',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image.jpg']
}

Ejemplo de composición multiimagen

javascriptCopiar
{
  model_name: 'flux-kontext-pro',
  prompt: 'Combine these images into a cohesive landscape scene',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.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.04,
      "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-pro"
}

Demasiadas imágenes

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

Buenas prácticas

Consejos para texto a imagen

1. Sé específico: Incluye detalles de sujeto, estilo, iluminación y composición
2. Selección de relación de aspecto: Elige la relación según tu caso de uso (16:9 para web, 9:16 para móvil)
3. Calidad del prompt: Los prompts más detallados suelen producir mejores resultados
4. Consulta eficiente: Comprueba el estado cada 2-3 segundos

Consejos para imagen a imagen

1. Instrucciones claras: Sé específico sobre la transformación deseada
2. Contexto multiimagen: Puede combinar hasta 5 imágenes para generación consciente del contexto
3. Guía de prompt: Describe el resultado deseado, no solo los cambios
4. Calidad de imagen: Las imágenes de entrada de mayor calidad producen mejores resultados

Casos de uso de ejemplo

Fotografía de producto

javascriptCopiar
{
  model_name: 'flux-kontext-pro',
  prompt: 'Professional product shot of luxury watch on marble surface',
  width: 4,
  height: 3
}

Collage multiimagen

javascriptCopiar
{
  model_name: 'flux-kontext-pro',
  image_url_list: ['photo1.jpg', 'photo2.jpg', 'photo3.jpg'],
  prompt: 'Create a seamless collage with these vacation photos',
  width: 16,
  height: 9
}

Transferencia de estilo

javascriptCopiar
{
  model_name: 'flux-kontext-pro',
  image_url_list: ['photo.jpg'],
  prompt: 'Transform into impressionist painting style',
  width: 1,
  height: 1
}