Usa l'API RunComfy per eseguire happyhorse/happyhorse-1.0/reference-to-video. Per input e output accettati, consulta lo schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
"prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
}'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/happyhorse/happyhorse-1.0/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
"prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
}'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": [
"image_url_1",
"prompt"
],
"properties": {
"image_url_1": {
"title": "Immagine di riferimento 1 (personaggio1)",
"description": "Prima immagine di riferimento. Contrassegna questo argomento nel prompt come carattere1. Formato: JPEG, JPG, PNG o WEBP. Lato corto ≥ 400px, consigliato 720P o superiore, max 10MB.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
},
"image_url_2": {
"title": "Immagine di riferimento 2 (personaggio2)",
"description": "Seconda immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere2. Formato: JPEG, JPG, PNG o WEBP. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_3": {
"title": "Immagine di riferimento 3 (carattere3)",
"description": "Terza immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere3. Formato: JPEG, JPG, PNG o WEBP. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_4": {
"title": "Immagine di riferimento 4 (carattere 4)",
"description": "Quarta immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere4. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_5": {
"title": "Immagine di riferimento 5 (carattere5)",
"description": "Quinta immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere5. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_6": {
"title": "Immagine di riferimento 6 (carattere6)",
"description": "Sesta immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere6. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_7": {
"title": "Immagine di riferimento 7 (carattere7)",
"description": "Settima immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere7. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_8": {
"title": "Immagine di riferimento 8 (carattere 8)",
"description": "Ottava immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere8. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_9": {
"title": "Immagine di riferimento 9 (carattere 9)",
"description": "Nona immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere9. Lascia vuoto per saltare.",
"type": "string"
},
"prompt": {
"title": "Prompt",
"description": "Descrivi la scena, il movimento, la telecamera e l'illuminazione. Fai riferimento a ciascuna immagine di riferimento con carattere1, carattere2, carattere3... nell'ordine in cui appaiono sopra. Massimo 2500 caratteri cinesi/5000 non cinesi.",
"type": "string",
"default": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look.",
"maxLength": 5000
},
"aspect_ratio": {
"title": "Proporzioni (L:A)",
"description": "Proporzioni video in uscita.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"default": "16:9"
},
"resolution": {
"title": "Risoluzione",
"description": "Risoluzione video in uscita. Il modello supporta 720P o 1080P.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"duration": {
"title": "Durata",
"description": "Durata del video in uscita in secondi. Valori consentiti: 3–15.",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"seed": {
"title": "Seme",
"description": "Seme opzionale per generazioni riproducibili. Utilizzare 0 per consentire al provider di randomizzare.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "Filigrana",
"description": "Se mantenere la filigrana del provider sul video generato.",
"type": "boolean",
"default": false
}
}
}{
"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.