Introduzione
HappyHorse 1.1 Immagine in video anima un fotogramma iniziale fornito in image_url. Il prompt è obbligatorio e descrive il movimento che segue; la clip dura da 3 a 15 secondi interi a 720p o 1080p, con una colonna sonora generata. Non esiste un campo per il formato né uno per il fotogramma finale: la forma la decide l’immagine, e la chiusura è il punto in cui arriva il movimento richiesto.
Scegli il metodo in base al materiale di partenza
| Materiale di partenza | Metodo |
|---|---|
| una scena scritta o una sceneggiatura | HappyHorse 1.1 Testo in video |
| un’immagine iniziale approvata | HappyHorse 1.1 Immagine in video |
| da una a nove immagini di riferimento | HappyHorse 1.1 Riferimenti in video |
Caratteristiche principali
L’immagine decide soggetto e forma
Il fotogramma iniziale viene seguito da vicino, e questo fa dell’endpoint la strada affidabile verso un risultato letterale, fotogrammi di partenza senza censura compresi. Nell’esempio tailgate-turn costume, pick-up e controluce arrivano dal fotogramma, e il prompt le chiede solo di abbassare la bottiglia, far oscillare una volta gli stivali e girare la testa verso il sole basso.
Nessun fotogramma finale da inseguire
Questo endpoint accetta solo image_url, quindi un’inquadratura non si può ancorare a una composizione finale. Funzionano meglio i movimenti che si risolvono da soli. L’esempio quiet-hold è fatto di quattro secondi di quasi immobilità: un respiro, una spalla che scende e un cambio di peso contro lo stipite della finestra, con la camera quasi ferma.
Limiti di ingresso e di uscita
Il fotogramma iniziale deve avere almeno 300 px per lato, un rapporto tra 1:2,5 e 2,5:1 e un peso fino a 20 MB. L’uscita dura da 3 a 15 secondi, con 5 come predefinito, a 720p (predefinito) o 1080p, e la colonna sonora viene sempre generata insieme all’immagine.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio. Descrivi ciò che cambia dopo il fotogramma – azione, macchina, ritmo – non il fotogramma stesso. almeno 1 caratteri · al massimo 2500 caratteri |
image_url | Sì | Il fotogramma iniziale. Fissa soggetto e composizione e determina la forma dell'output. |
resolution | No | 720p o 1080p. |
duration_seconds | No | Secondi interi, da 3 a 15. Non c'è un fotogramma di chiusura, quindi tieni il movimento risolvibile in quel tempo. |
seed | No | Intero da 0 a 2147483647 per la partenza casuale; se lo ometti, ogni esecuzione ne estrae uno proprio. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.14 / secondo |
| $0.18 / secondo |
Casi d’uso
Animare un fotogramma senza censura o curato nell’art direction
Questa strada segue il fotogramma che riceve, quindi il lavoro senza censura comincia qui e non in text-to-video, che rifiuta i prompt oltre il suo limite di contenuto. Fornisci il fotogramma che hai progettato e scrivi solo il movimento; il soggetto appare così come è stato disegnato o fotografato, invece di essere reinterpretato da una frase.
Movimento dell’ambiente attorno a una posa ferma
L’esempio wasteland-hood-two lascia due figure sul cofano di un’auto in panne e scrive solo ciò che esiste in movimento: stoffa strappata che il vento solleva e lascia ricadere, una foschia di calore che ondeggia, mulinelli di polvere che attraversano la strada e un lento avvicinamento. È stato generato a 1080p con la durata predefinita.
Brevi inserti e stacchi
Una clip di tre o quattro secondi con un movimento di camera minimo è adatta agli inserti tra inquadrature più lunghe. Limita l’azione a un respiro o a un gesto, come fa quiet-hold, così il movimento si chiude entro la durata invece di interrompersi a metà.
Consigli avanzati
Dai al prompt solo movimento
Il prompt è obbligatorio, quindi usalo per ciò che cambia: azione, camera e ritmo. Il prompt di wasteland-hood-two non descrive mai la composizione; descrive vento, foschia e polvere. Descrivere di nuovo il fotogramma consuma il limite di 2.500 caratteri per ciò che l’immagine ha già fissato.
Commisura il movimento alla durata
Senza fotogramma finale, un movimento che non riesce a finire nel tempo scelto si ferma semplicemente dove finisce la clip. Adatta l’azione alla durata: un gesto per una clip breve, una breve sequenza come abbassare, dondolare, girarsi per una più lunga, come fa tailgate-turn in sei secondi.
Ritaglia prima del caricamento
L’immagine stabilisce la forma dell’uscita, quindi ritagliala prima nel formato di consegna e controlla i limiti di dimensione. Fai bozze a 720p e ripeti a 1080p per la consegna. Ogni passaggio genera la sua ripresa, quindi tieni fisso il testo mentre confronti.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
