Skip to main content
POST

Modelos compatibles

Los tres modelos permiten generar imágenes a partir de texto y de 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:

Cuerpo de la solicitud

string
requerido
Nombre del modelo:
  • flux-2-flex
  • flux-2-pro
  • flux-2-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.
string
predeterminado:"2MP"
Ajuste predefinido de resolución de salida. Valores compatibles:
  • 1MP
  • 2MP (valor predeterminado)
  • 3MP
  • 4MP
Aquí, 1MP equivale a 1,048,576 píxeles.Para mantener la compatibilidad con integraciones anteriores, también se aceptan estos alias: 512, 512P y 1M equivalen a 1MP; 1K y 1024, a 2MP; 2K y 2048, a 3MP; 4K, a 4MP. Los demás valores se rechazan.Este ajuste determina las dimensiones de salida cuando size es una relación de aspecto. Se ignora cuando se proporcionan dimensiones exactas en píxeles mediante size o mediante width y height.
string
predeterminado:"1:1"
Relación de aspecto o dimensiones en píxeles de la imagen de salida.size también admite auto: cuando se proporciona image_urls, se usa la relación de aspecto de la imagen de referencia y se mantiene el nivel actual de resolution; sin una imagen de referencia, se utiliza el valor predeterminado 1:1.Opciones de tamaño compatibles:
  • 1:1 (valor predeterminado)
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
  • 21:9
  • 9:21
  • auto - usar la relación de aspecto de la imagen de referencia
También puedes proporcionar una cadena de dimensiones como 1024x1536. Las dimensiones exactas están sujetas a los mismos límites de píxeles que width y height.La prioridad es: el par width + height, una cadena de píxeles en size, resolution + relación de aspecto en size y, por último, el valor predeterminado 2MP + 1:1 (1440×1440).
integer
Anchura exacta de salida en píxeles. Si se proporciona, height también es obligatorio. Cada dimensión debe tener al menos 64 píxeles. Si solo se proporciona una dimensión, la tarea falla.Un par completo de width y height tiene la máxima prioridad y sustituye a resolution y size.
integer
Altura exacta de salida en píxeles. Si se proporciona, width también es obligatorio. Cada dimensión debe tener al menos 64 píxeles. Si solo se proporciona una dimensión, la tarea falla.La imagen de salida no debe superar los 4 MP (width × height ≤ 4 194 304) y la suma de la imagen de salida y todas las imágenes de referencia no debe superar los 9 MP.
array
Imágenes de referencia para generar imágenes a partir de otras imágenes. Proporciónalas mediante URL accesibles públicamente o en Base64.
  • Máximo: 8 imágenes
  • La suma de la imagen de salida y todas las imágenes de referencia no debe superar los 9 MP
string
predeterminado:"jpeg"
Formato de la imagen resultante: jpeg, png o webp. El valor predeterminado es jpeg.
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. El valor predeterminado es false; establécelo en true para activarlo. Define explícitamente false para desactivar la reescritura del prompt.
integer
predeterminado:"2"
Tolerancia de seguridad entre 0 y 5. Los valores más altos son más permisivos.
integer
predeterminado:"50"
Número de pasos de muestreo entre 1 y 50. Los valores más altos pueden mejorar el detalle, pero requieren más tiempo.Este parámetro solo es compatible con flux-2-flex. No lo envíes con flux-2-pro ni con flux-2-max.
number
predeterminado:"5.0"
Nivel de adherencia al prompt entre 1.5 y 10. Los valores más altos siguen el prompt con mayor precisión.Este parámetro solo es compatible con flux-2-flex. No lo envíes con flux-2-pro ni con flux-2-max.

Tabla de referencia de resoluciones

Ejemplos de uso

Generación a partir de texto

Generación a partir de imágenes de referencia

Dimensiones de salida exactas

Controles de FLUX.2 Flex

Respuesta

integer
Código de estado de la respuesta.
array
Array con el resultado del envío.

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

Ejemplo de una tarea fallida:
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

  1. Las tareas se procesan de forma asíncrona. La respuesta al envío devuelve un task_id para realizar las consultas.
  2. El parámetro n debe ser 1; cada solicitud genera exactamente una imagen.
  3. Las imágenes de referencia pueden proporcionarse mediante una URL accesible públicamente o en Base64.
  4. Se admiten hasta 8 imágenes de referencia, sujetas al límite combinado de 9 MP para las imágenes de entrada y de salida.
  5. Las dimensiones exactas pueden indicarse mediante un size en píxeles o proporcionando juntos width y height. En este último caso, cada dimensión debe tener al menos 64 píxeles; la imagen de salida está limitada a 4 MP.
  6. El vencimiento de la URL del resultado lo determina el valor expires_at devuelto en la respuesta de la tarea.
  7. prompt_upsampling es false de forma predeterminada.