Introduzione
HunyuanVideo 1.5 Text to video trasforma un prompt scritto in un breve clip. HunyuanVideo 1.5 è il modello video aperto di Tencent da 8,3 miliardi di parametri; questo endpoint restituisce 5 o 8 secondi a 480p o 720p, in orizzontale o in verticale, con un negative prompt per gli artefatti. La piattaforma non aggiunge alcun filtro sui contenuti al prompt né al clip.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| una descrizione scritta | HunyuanVideo 1.5 Text to video |
| una foto da animare | HunyuanVideo 1.5 Image to video |
Caratteristiche principali
Persone naturali con un modello piccolo
Il modello ha 8,3 miliardi di parametri, eppure nelle nostre prove volti, pelle, capelli e tessuti sembravano fotografici e si muovevano senza sciogliersi.
Quattro dimensioni di fotogramma
aspect_ratio e resolution si combinano in 832 x 480, 480 x 832, 1280 x 720 o 720 x 1280: i clip verticali sono composti per lo schermo, non ritagliati.
Negative prompt
Elenca ciò che non vuoi mai vedere. È la correzione più rapida per testo indesiderato, mani deformate o sfocature.
Senza censura
Nessun filtro su prompt e risultato. Nelle nostre prove la maggior parte delle sonde sui contenuti è stata resa come scritta; la più forte ha trattenuto parte della scena.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi chi è in scena, cosa indossa e cosa fa, e cosa fa la macchina da presa. Funziona meglio con una sola azione chiara per clip. almeno 1 caratteri |
negative_prompt | No | Elenco facoltativo di ciò che vuoi tenere fuori, ad esempio «blurry, distorted hands, extra limbs, text, watermark». Non cambia il prezzo. |
aspect_ratio | No | 16:9 per l’orizzontale (predefinito) o 9:16 per il verticale. Il formato non cambia il prezzo. |
resolution | No | 480p (832 x 480) o 720p (1280 x 720, predefinito). Il 720p costa il doppio al secondo: fai le bozze a 480p. |
duration_seconds | No | 5 o 8 secondi, addebitati al secondo. |
seed | No | Mantiene confrontabili le esecuzioni mentre cambi una cosa alla volta. Non promette un clip identico fotogramma per fotogramma. |
Prezzi
Addebito al secondo di output alla risoluzione scelta. Le proporzioni non cambiano il prezzo.
| Specifiche | Prezzo |
|---|---|
| $0.024 / secondo |
| $0.048 / secondo |
Casi d’uso
Clip social verticali
9:16 a 720 x 1280 per feed e storie.
Esplorazione dei prompt
A 480p una bozza di cinque secondi costa poco, quindi puoi provare molti prompt prima di far crescere l’idea.
Clip senza filtro per la tua piattaforma
Nessun filtro sui contenuti, né sul prompt né sul clip, con solo adulti in scena.
Consigli avanzati
Scrivi l’inquadratura
Soggetto, abiti, azione, luce, camera: in quest’ordine, in due-quattro frasi.
Un’azione per clip
Cinque secondi sono un solo gesto o un solo movimento. Le catene di azioni si impastano.
Mantieni semplici le scene di contatto
Due persone a contatto tendono a confondere gli arti; un movimento lento e un’inquadratura più larga aiutano.
Bozza in piccolo
Lancia l’idea a 480p con un seed fisso, poi rilancia la migliore a 720p.
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": "tencent/hunyuan-video-1.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.
