Generación y edición de imágenes con FLUX Kontext

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-kontext-pro",
    "prompt": "Change hair color to blue",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
    "size": "16:9"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "flux-kontext-pro",
    "prompt": "Change hair color to blue",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
    "size": "16:9"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "flux-kontext-pro",
  prompt: "Change hair color to blue",
  image_urls: ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
  size: "16:9"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KFG5BBFNK1YQDTJDZY0P0QT2"
    }
  ]
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-kontext-pro",
    "prompt": "Change hair color to blue",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
    "size": "16:9"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "flux-kontext-pro",
    "prompt": "Change hair color to blue",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
    "size": "16:9"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "flux-kontext-pro",
  prompt: "Change hair color to blue",
  image_urls: ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
  size: "16:9"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KFG5BBFNK1YQDTJDZY0P0QT2"
    }
  ]
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-kontext-pro",
    "prompt": "Change hair color to blue",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
    "size": "16:9"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "flux-kontext-pro",
    "prompt": "Change hair color to blue",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
    "size": "16:9"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "flux-kontext-pro",
  prompt: "Change hair color to blue",
  image_urls: ["https://upload.apimart.ai/f/models/9998230420418352-159728fe-5ae8-4330-857a-a84c034d8d21-flux-kontext-pro.webp"],
  size: "16:9"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KFG5BBFNK1YQDTJDZY0P0QT2"
    }
  ]
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

Modelos compatibles

Modelo	Descripción
`flux-kontext-pro`	Generación y edición de imágenes según su contexto para flujos de uso general.
`flux-kontext-max`	Generación y edición de imágenes según su contexto con mayor calidad.

Ambos modelos permiten generar imágenes a partir de texto sin imágenes de referencia y editar imágenes mediante imágenes de referencia.

Autorización

string

requerido

Todos los endpoints requieren autenticación mediante Bearer Token.Obtén una clave en Gestión de claves de API y añádela al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo de la solicitud

string

requerido

Nombre del modelo:

flux-kontext-pro
flux-kontext-max

boolean

predeterminado:"false"

Indica si se debe moderar el contenido antes de enviar la tarea de imagen.

true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)

string

requerido

Descripción textual de la imagen que se generará o de la edición que se aplicará a las imágenes de referencia.

array

Imágenes de referencia para editar imágenes. Proporciónalas mediante URL accesibles públicamente o en Base64.

Máximo: 4 imágenes
La suma de la imagen de salida y todas las imágenes de referencia no debe superar los 9 MP

Si no se puede acceder a una URL de referencia, la tarea puede devolver temporarily unavailable dependency. Comprueba primero que la URL sea pública, no haya caducado y no bloquee el acceso externo.

string

predeterminado:"1:1"

Relación de aspecto de la imagen de salida. Relaciones de aspecto y modo automático compatibles:

1:1 (valor predeterminado)
4:3
3:4
16:9
9:16
3:2
2:3
21:9
9:21
auto - Seguir la relación de aspecto de la imagen de referencia

Cuando size se establece en auto, la salida sigue la relación de aspecto de la imagen de referencia si se proporciona image_urls. Si no hay una imagen de referencia, se usa la relación predeterminada 1:1.También se puede proporcionar una cadena de píxeles, como 1024x1536. Kontext la asigna a la relación compatible más cercana y no garantiza esas dimensiones exactas.El parámetro resolution no modifica la salida de Kontext, que se mantiene en torno a 1 MP. No envíes width ni height: Kontext no admite estos parámetros y la tarea fallará.

string

predeterminado:"png"

Formato de la imagen resultante: png, jpeg o webp. El valor predeterminado es png.

string

Parámetro de compatibilidad para la forma de la respuesta. Valores permitidos: url y b64_json. No cambia el formato de la imagen; si también se proporciona output_format, tiene prioridad output_format.

integer

predeterminado:"1"

Número de imágenes que se generan. Solo se admite el valor 1.

integer

Semilla aleatoria. Reutiliza la misma semilla y los mismos parámetros para obtener resultados reproducibles; omítela para usar una semilla aleatoria.

boolean

predeterminado:"false"

Indica si el prompt debe mejorarse y reescribirse antes de generar la imagen.Define este parámetro explícitamente como false para desactivar la reescritura del prompt.

integer

predeterminado:"2"

Tolerancia de seguridad entre 0 y 6. Los valores más altos son más permisivos.

Relaciones de aspecto compatibles

Relación de aspecto	Orientación
`1:1`	Cuadrada (valor predeterminado)
`4:3`	Horizontal
`3:4`	Vertical
`16:9`	Horizontal panorámica
`9:16`	Vertical
`3:2`	Horizontal clásica
`2:3`	Vertical clásica
`21:9`	Horizontal ultraancha
`9:21`	Vertical ultraalta

Dimensiones reales de salida

Relación	Dimensiones reales
`1:1`	1024×1024
`4:3`	1184×880
`3:4`	880×1184
`16:9`	1392×752
`9:16`	752×1392
`3:2`	1248×832
`2:3`	832×1248
`21:9`	1568×672
`9:21`	672×1568

Ejemplos de uso

Generación a partir de texto

{
  "model": "flux-kontext-pro",
  "prompt": "A cozy reading nook with warm lamplight",
  "size": "4:3"
}

Edición de imágenes

{
  "model": "flux-kontext-max",
  "prompt": "Replace the background with a beach while preserving the person",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "16:9",
  "output_format": "webp"
}

Varias imágenes de referencia

{
  "model": "flux-kontext-pro",
  "prompt": "Place the product from the first image into the room from the second image",
  "image_urls": [
    "https://example.com/product.jpg",
    "https://example.com/room.jpg"
  ],
  "size": "4:3"
}

Respuesta

integer

Código de estado de la respuesta.

array

Array con el resultado del envío.

Mostrar Propiedades

string

Estado del envío. Una tarea aceptada correctamente devuelve submitted.

string

Identificador único de la tarea. Úsalo para consultar periódicamente el endpoint de tareas.

Obtener el resultado

Consulta periódicamente GET /v1/tasks/{task_id} hasta que la tarea alcance el estado completed o failed. Consulta la API de estado de tareas para ver el esquema completo de la respuesta. Una tarea completada incluye una imagen generada:

{
  "code": 200,
  "data": {
    "id": "task_01KFG5BBFNK1YQDTJDZY0P0QT2",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": ["https://upload.apimart.ai/f/image/xxxxxxxx-flux-kontext.png"],
          "expires_at": 1785220083
        }
      ]
    }
  }
}

La URL de la imagen se encuentra en data.result.images[0].url[0]. Su vencimiento lo determina la marca de tiempo Unix de data.result.images[0].expires_at; descarga la imagen antes de ese momento.

Estados de la tarea

Estado	Significado
`submitted` / `pending`	La tarea se ha aceptado o está en cola; sigue consultando
`processing`	La imagen se está generando; sigue consultando
`completed`	La tarea se ha completado; el resultado está en `result.images`
`failed`	La tarea ha fallado; el motivo está en `data.error.message` y se realiza un reembolso completo

Ejemplo de una tarea fallida:

{
  "code": 200,
  "data": {
    "status": "failed",
    "error": {
      "type": "task_failed",
      "code": "task_failed",
      "message": "width/height are not supported by flux-kontext-pro"
    }
  }
}

Los parámetros de modelo no válidos no generan un error 400 síncrono. El envío devuelve HTTP 200 y un task_id; al consultar la tarea, esta pasa a failed. El motivo específico siempre está en error.message, mientras que error.code es task_failed. Las tareas fallidas se reembolsan por completo.

Notas

Las tareas se procesan de forma asíncrona. La respuesta al envío devuelve un task_id para realizar las consultas.
El parámetro n debe ser 1; cada solicitud genera exactamente una imagen.
Las imágenes de referencia pueden proporcionarse mediante una URL accesible públicamente o en Base64.
Se admiten hasta 4 imágenes de referencia, y la suma de la salida y todas las referencias no debe superar los 9 MP.
Define explícitamente prompt_upsampling: false para desactivar la reescritura del prompt.
El vencimiento de la URL del resultado lo determina el valor expires_at devuelto en la respuesta de la tarea.

Visión general

Modelos

Serie de texto

Serie de imágenes

Serie de video

Serie de audio

Serie de Moderación

Gestión de subidas

Gestión de tareas

Gestión de cuenta

Generación y edición de imágenes con FLUX Kontext

Modelos compatibles

Autorización

Cuerpo de la solicitud

Relaciones de aspecto compatibles

Dimensiones reales de salida

Ejemplos de uso

Generación a partir de texto

Edición de imágenes

Varias imágenes de referencia

Respuesta

Obtener el resultado

Estados de la tarea

Notas

​Modelos compatibles

​Autorización

​Cuerpo de la solicitud

​Relaciones de aspecto compatibles

​Dimensiones reales de salida

​Ejemplos de uso

​Generación a partir de texto

​Edición de imágenes

​Varias imágenes de referencia

​Respuesta

​Obtener el resultado

​Estados de la tarea

​Notas

Modelos compatibles

Autorización

Cuerpo de la solicitud

Relaciones de aspecto compatibles

Dimensiones reales de salida

Ejemplos de uso

Generación a partir de texto

Edición de imágenes

Varias imágenes de referencia

Respuesta

Obtener el resultado

Estados de la tarea

Notas