Usa l'API RunComfy per eseguire blackforestlabs/flux-3-max/text-to-video. Per input e output accettati, consulta lo schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A young man with tousled light brown hair and a charcoal overcoat speaks from the stone steps of a red-brick courthouse in a New England town in autumn. Only the crowd's hands show at the bottom of the frame. No signs, no captions, no readable flags. He lifts one hand as fallen leaves cross the steps. A clear speaking voice and distant traffic."
}'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-3-max/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A young man with tousled light brown hair and a charcoal overcoat speaks from the stone steps of a red-brick courthouse in a New England town in autumn. Only the crowd's hands show at the bottom of the frame. No signs, no captions, no readable flags. He lifts one hand as fallen leaves cross the steps. A clear speaking voice and distant traffic."
}'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": "Descrivi il soggetto, l'azione, la fotocamera, la luce e qualsiasi suono tu voglia.",
"type": "string",
"default": "A young man with tousled light brown hair and a charcoal overcoat speaks from the stone steps of a red-brick courthouse in a New England town in autumn. Only the crowd's hands show at the bottom of the frame. No signs, no captions, no readable flags. He lifts one hand as fallen leaves cross the steps. A clear speaking voice and distant traffic."
},
"aspect_ratio": {
"title": "Formato",
"description": "Forma del frame di output. auto utilizza 16:9 quando nessuna immagine è allegata.",
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "16:9"
},
"resolution": {
"title": "Risoluzione",
"description": "Risoluzione di output. 720p è il valore predefinito. 1080p è l'opzione più nitida.",
"type": "string",
"enum": [
"720p",
"1080p"
],
"default": "720p"
},
"duration": {
"title": "Durata",
"description": "Lunghezza del clip in secondi interi.",
"type": "integer",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
],
"default": 5
},
"generate_audio": {
"title": "Genera audio",
"description": "Crea una traccia audio con il video. Disattivalo per un clip silenzioso.",
"type": "boolean",
"default": true
},
"reasoning_level": {
"title": "Livello di ragionamento",
"description": "low ritorna prima. high passa più tempo sul prompt ed è più lento.",
"type": "string",
"enum": [
"low",
"high"
],
"default": "high"
},
"seed": {
"title": "Seed",
"description": "Opzionale. Lascia vuoto e il modello sceglie un seme casuale.",
"type": "integer"
}
}
}{
"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.