Generar una imagen FLUX

POST

flux

{model}

curl https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "seed": 424242,
    "width": 1280,
    "height": 768,
    "output_format": "png"
  }'

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

Descripción general

POST /flux/v1/\{model\} genera una imagen con una solicitud nativa en formato BFL. Las solicitudes son asíncronas de forma predeterminada. Almacene el valor de nivel superior de la respuesta id y luego sondee GET /flux/v1/get_result con ese ID de tarea. Para esperar la imagen en la misma solicitud, envíe "async": false en el cuerpo JSON. Una respuesta síncrona correcta contiene status: "Ready" y la URL de la imagen en result.sample. El playground de la API incluye ejemplos de solicitudes de texto a imagen para FLUX.2 Pro, Flex y Max. Consulte la página de modelos o /v1/models para conocer los ID de modelo y la disponibilidad de la cuenta.

Campos de solicitud

Comience con prompt, width, height y output_format. También puede enviar seed; el resultado completado puede informar la semilla utilizada, pero ese campo por sí solo no garantiza una salida reproducible. El campo opcional async controla cómo devuelve la solicitud. Use el valor booleano JSON false para la generación síncrona. Use true u omita el campo para la generación asíncrona. No envíe una cadena como "false". Para la edición de imágenes de referencia, envíe una URL pública de imagen HTTPS en input_image. Este campo es compatible con los tres modelos FLUX.2 anteriores. FLUX.2 Pro también acepta una segunda URL pública HTTPS en input_image_2; incluya input_image siempre que envíe input_image_2.

Generar de forma síncrona

Seleccione Texto a imagen síncrono (FLUX.2 Pro) en los ejemplos de solicitudes para enviar "async": false. Mantenga la conexión abierta mientras se genera la imagen. El ejemplo utiliza un tiempo de espera del cliente de 300 segundos; esta es una configuración del cliente, no una fecha límite de finalización. Cuando la respuesta contenga status: "Ready", lea result.sample directamente. No es necesario sondear el resultado. Si la solicitud falla, gestione el error HTTP antes de leer el resultado. No combine async: false con webhook_url ni webhook_secret. Las solicitudes síncronas devuelven el resultado directamente y rechazan estos campos de webhook.

Enviar de forma asíncrona y sondear

Cuando async es true o se omite, la respuesta de creación devuelve un ID de tarea mientras continúa la generación. Use su id de nivel superior con el endpoint de resultados de CometAPI; los clientes no deben depender de un polling_url proporcionado por la respuesta. Sondee hasta que el endpoint de resultados devuelva status: "Ready". Considere Error, Failed, Failure, Task not found, Request Moderated y Content Moderated como fallos. Para otros estados, continúe sondeando dentro de los límites de reintentos y tiempo de espera de su aplicación.

Cuando una tarea esté lista, result.sample es una URL temporal de imagen. Descárguela o transfiérala de inmediato; no dependa de una duración fija.

Autorizaciones

Authorization

string

header

requerido

Bearer token authentication. Use your CometAPI key.

Parámetros de ruta

model

string

requerido

FLUX.2 model ID in the URL path. Check /v1/models or the Models page for account availability.

Cuerpo

application/json

prompt

string

requerido

Text prompt describing the image or reference-image edit.

Ejemplo:

"A clean editorial photograph of a red ceramic teapot on a pale blue table, soft window light, no text."

async

boolean

predeterminado:true

Controls whether generation returns asynchronously. Set false to wait for the finished image and read result.sample from the successful response. Set true or omit this field to receive a task ID for polling. Use a JSON boolean, not a string. Do not combine false with webhook_url or webhook_secret.

input_image

string

Public HTTPS URL of the first reference image. Replace the example URL with a publicly accessible image. This editing field is available for the FLUX.2 models covered by this reference.

Ejemplo:

"https://your-image-host/reference-one.jpg"

input_image_2

string

Public HTTPS URL of a second reference image for flux-2-pro. Replace the example URL and also send input_image.

Ejemplo:

"https://your-image-host/reference-two.jpg"

seed

integer

Optional seed value. A completed result can report the used seed; that field alone does not establish repeatable output.

width

integer

Requested output width in pixels. Use a dimension supported by the selected model.

Ejemplo:

1280

height

integer

Requested output height in pixels. Use a dimension supported by the selected model.

Ejemplo:

768

output_format

string

Requested output image format supported by the selected model. The examples use png.

Ejemplo:

"png"

Respuesta

200 - application/json

With async: false, successful generation returns status: "Ready" and the image URL in result.sample. With async: true or no async field, save the top-level id and poll the CometAPI result endpoint.

string

requerido

Task ID to pass to GET /flux/v1/get_result?id=....

status

string

requerido

Task state. A successful synchronous response returns Ready. An asynchronous submission can return Pending while generation continues.

result

object | null

Generation result. A successful synchronous response contains the finished image. An asynchronous submission can return an empty or null result.

Show child attributes

polling_url

string | null

Response-supplied convenience URL when returned. Clients should poll the documented CometAPI result route by the top-level id.

cost

number | null

Numeric billing coefficient when returned. This field is not documented as a currency or credit amount.

input_mp

number | null

Input image megapixels when returned.

output_mp

number | null

Output image megapixels when returned.

progress

number | null

Task progress when returned.

details

any

Additional task details when returned.

preview

any

Task preview data when returned.

Última modificación el 21 de septiembre de 2026

curl https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "seed": 424242,
    "width": 1280,
    "height": 768,
    "output_format": "png"
  }'

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

Moderación de contenido

Claves API

Descripción general

Campos de solicitud

Generar de forma síncrona

Enviar de forma asíncrona y sondear

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Descripción general

​Campos de solicitud

​Generar de forma síncrona

​Enviar de forma asíncrona y sondear

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Descripción general

Campos de solicitud

Generar de forma síncrona

Enviar de forma asíncrona y sondear