img_uuid restituito, quindi esegui il polling o ricevi callback HTTPS per il risultato.API HappyHorse 1.1 per la generazione video
Accedi all'API HappyHorse 1.1 tramite l'Open API indipendente di GoEnhance per workflow da testo a video, da immagine a video (primo fotogramma) o con immagine di riferimento separata. Invia un'attività asincrona, salva l'
Crea una chiave API
Scegli la modalità API HappyHorse corretta
Da testo a video
Invia model: happyhorse-1-1 con un prompt obbligatorio e nessun image_url. Seleziona un rapporto, una durata e una risoluzione documentati per il video generato.
Da immagine a video (primo fotogramma)
Aggiungi image_url per animare un primo fotogramma. L'immagine deve essere JPEG, PNG o WEBP, di almeno 300px, inferiore a 10MB e rientrare nell'intervallo di rapporto documentato da 1:2.5 a 2.5:1.
Video con immagine di riferimento
Usa model: happyhorse-1-1-ref con 1–9 URL in image_urls. Fai riferimento a ciascuna fonte nel prompt come [Image 1], [Image 2] e così via.
Convalida la modalità di richiesta selezionata prima di inviare il lavoro alla tua coda di produzione.
Funzionalità e limiti dell'API HappyHorse 1.1
Due modalità di input standard
Usa solo un prompt per il testo a video o aggiungi un <code>image_url</code> per il primo fotogramma da immagine a video.
Modello multi-riferimento separato
Usa <code>happyhorse-1-1-ref</code> con 1–9 URL di immagini di riferimento obbligatori; non supporta il testo a video puro.
Durata da 3 a 15 secondi
Imposta <code>duration</code> su un numero intero da 3 a 15 secondi. Il valore predefinito documentato è 5 secondi.
Output 720p o 1080p
Scegli <code>720p</code> o <code>1080p</code>. Il valore predefinito documentato è <code>720p</code>.
Rapporti ritratto, quadrato e paesaggio
Il percorso standard supporta 16:9, 9:16, 1:1, 4:3 e 3:4. La modalità di riferimento elenca anche 4:5 e 5:4.
Polling e callback
Conserva l'<code>img_uuid</code>, esegui il polling dell'endpoint dei dettagli del lavoro o fornisci un URL di callback HTTPS pubblico per gli aggiornamenti di stato.
GoEnhance documenta prezzi al secondo di $0,02 per token e attualmente classifica queste tariffe come offerta a tempo limitato.
Prezzi API di HappyHorse 1.1
720p: $0,104 al secondo
La generazione a 720p utilizza 5,2 token al secondo. Una richiesta di 5 secondi utilizza 26 token, ovvero $0,52 secondo la conversione documentata.
1080p: $0,144 al secondo
La generazione a 1080p utilizza 7,2 token al secondo, pari a $0,144 per secondo generato.
Stima per durata
Moltiplica la tariffa al secondo selezionata per la durata richiesta di 3–15 secondi. Controlla il riferimento API in tempo reale prima di procedere con l'elaborazione in blocco, poiché i prezzi promozionali possono variare.
Integra l'API di HappyHorse 1.1
1
1. Crea e proteggi una chiave API
Crea una chiave GoEnhance e inviala come autorizzazione bearer da un codice lato server attendibile.
2
2. Seleziona il modello
Scegli
happyhorse-1-1 per la generazione basata solo su prompt o primo fotogramma, oppure happyhorse-1-1-ref per 1–9 immagini di riferimento. 3
3. Costruisci e valida il payload
Fornisci il prompt richiesto, quindi valida i campi immagine, durata, risoluzione, proporzioni e URL di callback per la modalità scelta.
4
4. Invia l'attività video
Esegui una richiesta POST a
https://api.goenhance.ai/api/v1/videos/generations e archivia l'img_uuid restituito. 5
5. Monitora lo stato
Esegui il polling su
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... o ricevi le modifiche di stato tramite una callback HTTPS pubblica. 6
6. Gestisci il risultato finale
Elabora successi ed errori in modo idempotente, verifica l'asset restituito ed evita il lavoro a valle duplicato quando il polling e le callback si sovrappongono.
Collega le richieste di generazione strutturata ai flussi di lavoro di revisione, archiviazione e distribuzione.
Casi d'uso per sviluppatori dell'API HappyHorse
Varianti video per campagne
Genera brevi concept in movimento da prompt strutturati per revisione creativa ed editing a valle.
Movimento per prodotti e brand
Anima un primo fotogramma approvato mentre il tuo backend controlla durata, risoluzione e gestione del completamento.
Studi di interazione tra personaggi
Utilizza il modello di riferimento per descrivere come i soggetti provenienti da immagini sorgente approvate debbano apparire insieme in una scena.
Previsualizzazione di storyboard
Trasforma le descrizioni delle riprese in clip revisionabili prima di impegnarti in un flusso di lavoro di produzione più ampio.
Pipeline creative localizzate
Parametrizza i prompt per varianti regionali mantenendo coerenti l'invio e il monitoraggio delle attività.
Code di asset automatizzate
Collega la generazione, la persistenza dello stato del lavoro, le callback, l'archiviazione e l'approvazione umana in un servizio backend.
Risposte su prezzi, modalità di richiesta, limiti di input e gestione delle attività asincrone.