Usa l'API RunComfy per eseguire blackforestlabs/flux-2/max/text-to-image. Per input e output accettati, consulta lo schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2/max/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A majestic snow-covered mountain at sunrise, resembling Mount Hood, towering in the center of the composition with dramatic lighting highlighting the upper ridges in warm orange and pink hues. The peak is partially draped in wisps of low-hanging clouds and mist, creating a dreamy atmosphere. Dense evergreen forest forms a dark silhouette in the foreground, while the mid-ground slopes are detailed with snow trails and natural rock striations. The sky is filled with a mix of deep indigo, mauve, and golden-orange clouds, with light breaking through from the left side, illuminating the scene with a soft, cinematic glow. Photorealistic, high detail, 8k resolution, golden hour lighting, ultra-realistic rendering, Unreal Engine style landscape scene, hyper-detailed textures, moody and atmospheric."
}'Imposta la variabile d'ambiente YOUR_API_TOKEN con la tua chiave API (gestione nel Profilo) e includi in ogni richiesta un token Bearer nell'intestazione Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2/max/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A majestic snow-covered mountain at sunrise, resembling Mount Hood, towering in the center of the composition with dramatic lighting highlighting the upper ridges in warm orange and pink hues. The peak is partially draped in wisps of low-hanging clouds and mist, creating a dreamy atmosphere. Dense evergreen forest forms a dark silhouette in the foreground, while the mid-ground slopes are detailed with snow trails and natural rock striations. The sky is filled with a mix of deep indigo, mauve, and golden-orange clouds, with light breaking through from the left side, illuminating the scene with a soft, cinematic glow. Photorealistic, high detail, 8k resolution, golden hour lighting, ultra-realistic rendering, Unreal Engine style landscape scene, hyper-detailed textures, moody and atmospheric."
}'Recupera lo stato corrente per 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>"Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Fornisci un URL HTTPS raggiungibile pubblicamente. L'host deve consentire fetch lato server (senza login/cookie), senza rate limit eccessivo o blocco bot. Consigliato: immagini ≤ 50 MB (~4K), video ≤ 100 MB (~2–5 min a 720p). Per asset privati, URL stabili o pre-firmati.
{
"type": "object",
"title": "Schema di input",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "",
"type": "string",
"default": "A majestic snow-covered mountain at sunrise, resembling Mount Hood, towering in the center of the composition with dramatic lighting highlighting the upper ridges in warm orange and pink hues. The peak is partially draped in wisps of low-hanging clouds and mist, creating a dreamy atmosphere. Dense evergreen forest forms a dark silhouette in the foreground, while the mid-ground slopes are detailed with snow trails and natural rock striations. The sky is filled with a mix of deep indigo, mauve, and golden-orange clouds, with light breaking through from the left side, illuminating the scene with a soft, cinematic glow. Photorealistic, high detail, 8k resolution, golden hour lighting, ultra-realistic rendering, Unreal Engine style landscape scene, hyper-detailed textures, moody and atmospheric."
},
"image_size": {
"title": "Dimensione immagine",
"description": "Scegli una dimensione predefinita.",
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
],
"default": "landscape_4_3"
},
"seed": {
"title": "Seed",
"description": "",
"type": "integer",
"default": 0
},
"output_format": {
"title": "Formato di output",
"description": "Il formato dell'immagine generata.",
"type": "string",
"enum": [
"jpeg",
"png"
],
"default": "jpeg"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL immagine singola"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL video singolo"
},
"images": {
"type": "array",
"description": "più URL immagine",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "più URL video",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy è la piattaforma principale ComfyUI che offre ComfyUI online ambiente e servizi, insieme a workflow di ComfyUI con visuali mozzafiato. RunComfy offre anche AI Models, consentire agli artisti di sfruttare gli ultimi strumenti di AI per creare arte incredibile.