Use a API RunComfy para executar blackforestlabs/flux-2/turbo/text-to-image. Para entradas e saídas aceitas, consulte o 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."
}'Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.
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."
}'Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.
{
"type": "object",
"title": "Esquema de entrada",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Descrição textual da imagem que será gerada.",
"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 orientação",
"description": "Controla o quanto o modelo segue o prompt (0–20; padrão: 2,5).",
"type": "float",
"minimum": 0,
"maximum": 20,
"default": 2.5
},
"seed": {
"title": "Seed",
"description": "Semente para resultados reproduzíveis (padrão: 0).",
"type": "integer",
"default": 0
},
"image_size": {
"title": "Tamanho da imagem",
"description": "Tamanho de saída entre os formatos fixos `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3` e `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 saída",
"description": "Formato do arquivo gerado: `jpeg`, `png` ou `webp`.",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
],
"default": "png"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL de imagem única"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL de vídeo único"
},
"images": {
"type": "array",
"description": "várias URLs de imagem",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "várias URLs de vídeo",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.