Riferimento API di HunyuanVideo 1.5
Il modello video aperto di Tencent per clip brevi da 5–8 secondi
Con una sola chiave API di PopNow chiami HunyuanVideo 1.5 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.
Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.
In sintesi
- Sviluppato da
- Tencent
- Risultato
- Video
- Da
- 3.6 crediti per secondo generato ($0.036)
1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.
Crea video
tencent/hunyuan-video-1.5/text-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
480p | 3.6 | $0.036 |
720p | 7.2 | $0.072 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
promptObbligatorio | string | — | — | Describe the scene, the action and the camera. |
negative_promptFacoltativo | string | — | — | Things to keep out of the clip, such as blur, extra limbs or text. |
aspect_ratioFacoltativo | string | 16:9 | 16:9, 9:16 | Output aspect ratio. |
resolutionFacoltativo | string | 720p | 480p, 720p | Output resolution. |
duration_secondsFacoltativo | integer | 5 | 5, 8 | Output length: 5 or 8 seconds. Billed per second. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed for controlled comparisons, not a frame-identical guarantee. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
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: $(uuidgen)" \
-d '{
"model": "tencent/hunyuan-video-1.5/text-to-video",
"input": {
"prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
"duration_seconds": 5,
"resolution": "720p"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Da immagine a video
tencent/hunyuan-video-1.5/image-to-video
Prezzo
| Opzione | Crediti (per secondo generato) | Dollari USA |
|---|---|---|
480p | 3.6 | $0.036 |
720p | 7.2 | $0.072 |
Parametri
| Campo | Tipo | Predefinito | Valori ammessi | A cosa serve |
|---|---|---|---|---|
image_urlObbligatorio | string (uri) | — | — | Opening frame. The clip starts from this image and keeps its aspect ratio. |
promptFacoltativo | string | — | — | Optional: describe the motion and the camera. Leave it empty to let the model animate the frame on its own. |
resolutionFacoltativo | string | 720p | 480p, 720p | Output resolution. |
duration_secondsFacoltativo | integer | 5 | 5, 8 | Output length: 5 or 8 seconds. Billed per second. |
seedFacoltativo | integer | — | da 0 a 2147483647 | Random seed for controlled comparisons, not a frame-identical guarantee. |
Richiesta di esempio
Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.
L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.
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: $(uuidgen)" \
-d '{
"model": "tencent/hunyuan-video-1.5/image-to-video",
"input": {
"prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"duration_seconds": 5,
"resolution": "720p"
}
}'La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"