Inicio rápido de FLUX API: genera imágenes con CometAPI

Lo que crearás

Enviarás una tarea PNG de 1280x768 a FLUX.2 Pro, almacenarás el id de la tarea devuelto, consultarás GET /flux/v1/get_result y descargarás result.sample cuando la tarea pase a estar Ready. Para una solicitud síncrona, envía "async": false y lee result.sample de la respuesta de creación. Consulta Generar de forma síncrona para ver ejemplos completos.

Requisitos previos

Una clave de API de CometAPI almacenada en COMETAPI_KEY
curl y jq, Python 3.10+ con requests o Node.js 18+
Acceso a flux-2-pro en tu cuenta de CometAPI

Endpoints y autenticación

Envía la tarea:

POST https://api.cometapi.com/flux/v1/flux-2-pro

Consulta el estado con el id de nivel superior devuelto por la respuesta de creación:

GET https://api.cometapi.com/flux/v1/get_result?id=<task_id>

Autentica ambas solicitudes de CometAPI con:

Authorization: Bearer $COMETAPI_KEY

Ejemplos de código

set -e

CREATE_RESPONSE=$(curl --max-time 60 -fSs 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.",
    "width": 1280,
    "height": 768,
    "output_format": "png",
    "seed": 424242
  }')

TASK_ID=$(printf "%s" "$CREATE_RESPONSE" | jq -r '.id')

for ATTEMPT in $(seq 1 60); do
  RESULT=$(curl --max-time 30 -fSs "https://api.cometapi.com/flux/v1/get_result?id=$TASK_ID" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  STATUS=$(printf "%s" "$RESULT" | jq -r '.status')
  echo "status: $STATUS"

  case "$STATUS" in
    Ready)
      IMAGE_URL=$(printf "%s" "$RESULT" | jq -r '.result.sample')
      curl --max-time 60 -fL "$IMAGE_URL" -o flux-result.png
      exit 0
      ;;
    Error|Failed|Failure|"Task not found"|"Request Moderated"|"Content Moderated"|failed|failure)
      echo "FLUX task failed: $STATUS" >&2
      exit 1
      ;;
  esac

  sleep 5
done

echo "FLUX task did not finish in time" >&2
exit 1

import os
import time
from pathlib import Path

import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
payload = {
    "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."
    ),
    "width": 1280,
    "height": 768,
    "output_format": "png",
    "seed": 424242,
}

create_response = requests.post(
    "https://api.cometapi.com/flux/v1/flux-2-pro",
    headers={**headers, "Content-Type": "application/json"},
    json=payload,
    timeout=60,
)
create_response.raise_for_status()
task_id = create_response.json()["id"]

failure_statuses = {
    "Error",
    "Failed",
    "Failure",
    "Task not found",
    "Request Moderated",
    "Content Moderated",
    "failed",
    "failure",
}

for _ in range(60):
    result_response = requests.get(
        "https://api.cometapi.com/flux/v1/get_result",
        headers=headers,
        params={"id": task_id},
        timeout=30,
    )
    result_response.raise_for_status()
    result = result_response.json()
    status = result.get("status")
    print(status)

    if status == "Ready":
        image_response = requests.get(result["result"]["sample"], timeout=60)
        image_response.raise_for_status()
        Path("flux-result.png").write_bytes(image_response.content)
        break
    if status in failure_statuses:
        raise RuntimeError(f"FLUX task failed: {status}")

    time.sleep(5)
else:
    raise TimeoutError("FLUX task did not finish in time")

import fs from "node:fs/promises";

const authHeaders = {
  Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
};

const createResponse = await fetch(
  "https://api.cometapi.com/flux/v1/flux-2-pro",
  {
    method: "POST",
    headers: { ...authHeaders, "Content-Type": "application/json" },
    signal: AbortSignal.timeout(60_000),
    body: JSON.stringify({
      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.",
      width: 1280,
      height: 768,
      output_format: "png",
      seed: 424242,
    }),
  },
);

if (!createResponse.ok) throw new Error(await createResponse.text());
const { id } = await createResponse.json();

const failureStatuses = new Set([
  "Error",
  "Failed",
  "Failure",
  "Task not found",
  "Request Moderated",
  "Content Moderated",
  "failed",
  "failure",
]);
let completed = false;

for (let attempt = 0; attempt < 60; attempt += 1) {
  const resultResponse = await fetch(
    `https://api.cometapi.com/flux/v1/get_result?id=${encodeURIComponent(id)}`,
    { headers: authHeaders, signal: AbortSignal.timeout(30_000) },
  );
  if (!resultResponse.ok) throw new Error(await resultResponse.text());

  const result = await resultResponse.json();
  console.log(result.status);

  if (result.status === "Ready") {
    const imageResponse = await fetch(result.result.sample, {
      signal: AbortSignal.timeout(60_000),
    });
    if (!imageResponse.ok) throw new Error(await imageResponse.text());
    await fs.writeFile(
      "flux-result.png",
      Buffer.from(await imageResponse.arrayBuffer()),
    );
    completed = true;
    break;
  }
  if (failureStatuses.has(result.status)) {
    throw new Error(`FLUX task failed: ${result.status}`);
  }

  await new Promise((resolve) => setTimeout(resolve, 5000));
}

if (!completed) throw new Error("FLUX task did not finish in time");

Generar de forma síncrona

Para recibir la imagen terminada en la respuesta de creación, envíe el valor booleano JSON false en async. Una respuesta correcta tiene status: "Ready" y una URL de imagen en result.sample. Use true u omita async para usar el flujo de trabajo asíncrono anterior. No envíe "false" como una cadena ni combine async: false con webhook_url o webhook_secret. Estos ejemplos esperan hasta 300 segundos la respuesta de creación y luego descargan la imagen. El tiempo de espera es una configuración del cliente, no una fecha límite de finalización:

set -e

RESULT=$(curl \
  https://api.cometapi.com/flux/v1/flux-2-pro \
  --max-time 300 \
  --fail-with-body \
  --silent \
  --show-error \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red ceramic teapot on a pale blue table, soft window light.",
    "width": 1280,
    "height": 768,
    "output_format": "png",
    "seed": 424242,
    "async": false
  }')

if [ "$(printf '%s' "$RESULT" | jq -r '.status')" != "Ready" ]; then
  echo "FLUX generation did not return a Ready result" >&2
  exit 1
fi

IMAGE_URL=$(printf '%s' "$RESULT" | jq -er '.result.sample')
curl \
  "$IMAGE_URL" \
  --max-time 60 \
  --fail \
  --location \
  --output flux-result.png

import os
from pathlib import Path

import requests

response = requests.post(
    "https://api.cometapi.com/flux/v1/flux-2-pro",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "prompt": "A red ceramic teapot on a pale blue table, soft window light.",
        "width": 1280,
        "height": 768,
        "output_format": "png",
        "seed": 424242,
        "async": False,
    },
    timeout=300,
)
response.raise_for_status()
task = response.json()
if task.get("status") != "Ready":
    raise RuntimeError("FLUX generation did not return a Ready result")

image_response = requests.get(task["result"]["sample"], timeout=60)
image_response.raise_for_status()
Path("flux-result.png").write_bytes(image_response.content)

import fs from "node:fs/promises";

const response = await fetch(
  "https://api.cometapi.com/flux/v1/flux-2-pro",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    signal: AbortSignal.timeout(300_000),
    body: JSON.stringify({
      prompt: "A red ceramic teapot on a pale blue table, soft window light.",
      width: 1280,
      height: 768,
      output_format: "png",
      seed: 424242,
      async: false,
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
const task = await response.json();
if (task.status !== "Ready") {
  throw new Error("FLUX generation did not return a Ready result");
}

const imageResponse = await fetch(task.result.sample, {
  signal: AbortSignal.timeout(60_000),
});
if (!imageResponse.ok) throw new Error(await imageResponse.text());
await fs.writeFile(
  "flux-result.png",
  Buffer.from(await imageResponse.arrayBuffer()),
);

Cómo funciona el flujo

Con async: true o sin el campo async, el endpoint de creación devuelve una tarea id de nivel superior mientras continúa la generación. Consulte mediante sondeo el endpoint de resultados de CometAPI con ese id. Ready es el estado terminal correcto. Considere los estados conocidos de error y moderación como fallos, y siga consultando los demás estados solo hasta que venza el tiempo de espera del cliente. Con async: false, la respuesta de creación correcta contiene status: "Ready" y result.sample. Lea la URL de la imagen directamente sin realizar sondeos. Use result.sample únicamente para descargar la imagen terminada. Es una URL temporal y no debe usarse como almacenamiento persistente de la aplicación.

Parámetros comunes

Parámetro	Uso
`model` segmento de ruta	ID del modelo FLUX.2 en la ruta de la URL. Esta guía rápida usa `flux-2-pro`; consulte Modelos para conocer la disponibilidad de la cuenta.
`prompt`	Descripción de imagen o instrucción de edición obligatoria.
`async`	Booleano JSON opcional. `false` espera la imagen en la respuesta de creación; `true` o su omisión envía una tarea asíncrona. No combine `false` con `webhook_url` ni `webhook_secret`.
`width` / `height`	Dimensiones de salida solicitadas en píxeles.
`output_format`	Formato compatible con el modelo seleccionado. Esta guía rápida usa `png`.
`seed`	Valor de semilla opcional. El resultado puede informar la semilla utilizada; ese campo por sí solo no garantiza una salida reproducible.
`input_image`	URL HTTPS pública de imagen de referencia para edición.
`input_image_2`	Segunda URL HTTPS pública de imagen de referencia para FLUX.2 Pro; envíe también `input_image`.

Solución de problemas

La tarea permanece en estado de procesamiento

Continúe realizando consultas dentro de un bucle de reintentos limitado. Si se alcanza el tiempo de espera del cliente, conserve el ID de la tarea para inspeccionarla más adelante e informe que la solicitud agotó el tiempo de espera en lugar de que fue correcta.

La URL de la imagen ya no funciona

Descargue result.sample inmediatamente después de que la tarea pase a estar Ready, y luego coloque la imagen en un almacenamiento controlado por su aplicación.

Un campo de solicitud no tiene efecto

Use la referencia de la API para generar una imagen FLUX para elegir los campos de solicitud para su modelo. Compruebe los nombres de campo y los tipos JSON con el ejemplo de solicitud.

Siguientes pasos

Lea la referencia de la API para generar una imagen FLUX.
Consulte los resultados con Obtener un resultado de imagen FLUX.
Encuentre los modelos FLUX disponibles en Modelos.

Empieza aquí

Guías rápidas de la API de modelos

Guías principales de la API

Bibliotecas

Errores

Precios y facturación

Soporte

Inicio rápido de FLUX API: genera imágenes con CometAPI

Lo que crearás

Requisitos previos

Endpoints y autenticación

Ejemplos de código

Generar de forma síncrona

Cómo funciona el flujo

Parámetros comunes

Solución de problemas

Siguientes pasos

​Lo que crearás

​Requisitos previos

​Endpoints y autenticación

​Ejemplos de código

​Generar de forma síncrona

​Cómo funciona el flujo

​Parámetros comunes

​Solución de problemas

​Siguientes pasos

Lo que crearás

Requisitos previos

Endpoints y autenticación

Ejemplos de código

Generar de forma síncrona

Cómo funciona el flujo

Parámetros comunes

Solución de problemas

Siguientes pasos