Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
duration_seconds | No | Quanto dura la clip. Si paga al secondo. ≥ 3 · ≤ 15 · Predefinito: 5 |
image_url | Sì | L'immagine di partenza. |
prompt | Sì | Describe the scene, action, camera movement, and timing. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 720p · 1080p · Predefinito: 720p |
seed | No | Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647 |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti al secondo | ≈ USD |
|---|---|---|
| resolution 720p | 21 | 0,21 USD |
| resolution 1080p | 27 | 0,27 USD |
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di HappyHorse 1.1 in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model alibaba/happyhorse-1.1/image-to-video e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di HappyHorse 1.1
Quanto costa l’API di HappyHorse 1.1?
HappyHorse 1.1 costa da 105 crediti (1,05 USD) per una clip di 5 secondi con Da immagine a video, il suo task più economico. Prezzi per opzione: 720p 21 crediti al secondo, 1080p 27 crediti al secondo. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di HappyHorse 1.1 nell’API?
Inserisci alibaba/happyhorse-1.1/text-to-video per Crea video; alibaba/happyhorse-1.1/image-to-video per Da immagine a video; alibaba/happyhorse-1.1/reference-to-video per Da riferimenti a video nel campo model di POST /jobs/createTask.
Quante immagini di riferimento accetta HappyHorse 1.1?
Da una a nove su reference-to-video, dove il campo è obbligatorio. Inviale nell'ordine in cui il prompt le richiama e assegna a ogni immagine un solo compito: nove viste sovrapposte dello stesso soggetto vengono mediate, non conciliate.
Quali proporzioni sono disponibili?
Nove: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 e 21:9, con 16:9 come predefinita. Sono esposte su text-to-video e reference-to-video; image-to-video prende la forma dal fotogramma iniziale.
HappyHorse 1.1 genera audio?
Sì. Le clip tornano con una traccia audio generata anche se nessuno dei tre endpoint ha un campo audio, quindi non c'è modo di disattivarla. Descrivi nel prompt il suono che vuoi e silenzia o sostituisci la traccia in montaggio quando la clip va sotto un mix tuo.
Posso fissare l'ultimo fotogramma di un clip?
No. Su image-to-video non esiste un campo per il fotogramma di chiusura: c'è solo image_url. Se una ripresa deve atterrare su una composizione precisa, usa quella composizione come fotogramma iniziale di un movimento invertito, oppure raggiungila con uno stacco in montaggio.
Quali risoluzioni supporta?
720p e 1080p, con 720p predefinita su ogni endpoint. Fai le bozze a 720p, poi ripeti a 1080p la ripresa che vuoi: ogni passaggio estrae la propria ripresa, quindi tieni ferma la formulazione invece di aspettarti gli stessi fotogrammi.
Quali sono i limiti dell’API di HappyHorse 1.1?
Durata della clip: 3–15 s; Risoluzioni: 720p · 1080p; Lunghezza del prompt (caratteri): 2,500. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare HappyHorse 1.1 senza scrivere codice?
Sì. Il Playground esegue HappyHorse 1.1 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.

