Usa la API de RunComfy para ejecutar blackforestlabs/flux-2/turbo/text-to-image. Para entradas y salidas admitidas, consulta el esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2/turbo/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "> `Final prompt:` A photorealistic image of a white ceramic teacup lying on its side on a wrinkled, light gray fabric background. The teacup is filled with dried yellow flowers, with small clustered blossoms and brittle stems emerging from the rim. The flowers spill out naturally, maintaining an organic arrangement. The lighting is soft and diffused, typical of natural window light on an overcast day, creating subtle shadows and highlights on the fabric and cup. The scene is minimalistic and thoughtfully composed, evoking a calm, rustic atmosphere. The camera angle is slightly overhead with a gentle tilt, capturing the full cup at a diagonal orientation, and showing the handle at the bottom right. The photographic style is moody and still-life inspired, focusing on color contrast between the pale background and the muted yellow blossoms. Rendered in ultra-high resolution, 8k, with fine detail, realistic textures, and soft focus depth."
}'Define la variable de entorno YOUR_API_TOKEN con tu clave API (gestión en Perfil) e incluye en cada solicitud un token Bearer en la cabecera Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2/turbo/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "> `Final prompt:` A photorealistic image of a white ceramic teacup lying on its side on a wrinkled, light gray fabric background. The teacup is filled with dried yellow flowers, with small clustered blossoms and brittle stems emerging from the rim. The flowers spill out naturally, maintaining an organic arrangement. The lighting is soft and diffused, typical of natural window light on an overcast day, creating subtle shadows and highlights on the fabric and cup. The scene is minimalistic and thoughtfully composed, evoking a calm, rustic atmosphere. The camera angle is slightly overhead with a gentle tilt, capturing the full cup at a diagonal orientation, and showing the handle at the bottom right. The photographic style is moody and still-life inspired, focusing on color contrast between the pale background and the muted yellow blossoms. Rendered in ultra-high resolution, 8k, with fine detail, realistic textures, and soft focus depth."
}'Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Proporciona una URL HTTPS públicamente accesible. El host debe permitir peticiones del servidor (sin login/cookies), sin rate limit agresivo ni bloqueo de bots. Recomendado: imágenes ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min a 720p). Para activos privados, URLs estables o firmadas.
{
"type": "object",
"title": "Esquema de entrada",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Descripción textual de la imagen que se generará.",
"type": "string",
"default": "> `Final prompt:` A photorealistic image of a white ceramic teacup lying on its side on a wrinkled, light gray fabric background. The teacup is filled with dried yellow flowers, with small clustered blossoms and brittle stems emerging from the rim. The flowers spill out naturally, maintaining an organic arrangement. The lighting is soft and diffused, typical of natural window light on an overcast day, creating subtle shadows and highlights on the fabric and cup. The scene is minimalistic and thoughtfully composed, evoking a calm, rustic atmosphere. The camera angle is slightly overhead with a gentle tilt, capturing the full cup at a diagonal orientation, and showing the handle at the bottom right. The photographic style is moody and still-life inspired, focusing on color contrast between the pale background and the muted yellow blossoms. Rendered in ultra-high resolution, 8k, with fine detail, realistic textures, and soft focus depth."
},
"guidance_scale": {
"title": "Escala de guía",
"description": "Controla con qué rigor sigue el modelo el prompt (0–20; valor predeterminado: 2,5).",
"type": "float",
"minimum": 0,
"maximum": 20,
"default": 2.5
},
"seed": {
"title": "Semilla",
"description": "Semilla para obtener resultados reproducibles (valor predeterminado: 0).",
"type": "integer",
"default": 0
},
"image_size": {
"title": "Tamaño de imagen",
"description": "Tamaño de salida entre los formatos fijos `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3` y `landscape_16_9`.",
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
],
"default": "landscape_4_3"
},
"output_format": {
"title": "Formato de salida",
"description": "Formato de archivo de la imagen generada: `jpeg`, `png` o `webp`.",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
],
"default": "png"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL de una sola imagen"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL de un solo vídeo"
},
"images": {
"type": "array",
"description": "varias URLs de imagen",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "varias URLs de vídeo",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy es la principal ComfyUI plataforma, ofreciendo ComfyUI en línea entorno y servicios, junto con flujos de trabajo de ComfyUI con impresionantes imágenes. RunComfy también ofrece AI Models, permitiendo a los artistas aprovechar las últimas herramientas de AI para crear arte increíble.