Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
seed | No | Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647 |
prompt | Sì | Describe the picture and the action you want. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 720p · 1080p · 2k · 4k · Predefinito: 720p |
aspect_ratio | No | La forma dell'inquadratura: larga, quadrata o verticale. 16:9 · 9:16 · Predefinito: 16:9 |
duration_seconds | No | Quanto dura la clip. Si paga al secondo. ≥ 5 · ≤ 20 · Predefinito: 5 |
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 | 13,5 | 0,14 USD |
| resolution 1080p | 19,5 | 0,20 USD |
| resolution 2K | 28,5 | 0,29 USD |
| resolution 4K | 45 | 0,45 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 68 crediti per una clip di 5 secondi (0,68 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 LTX 2.5 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 lightricks/ltx-2.5/text-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": "lightricks/ltx-2.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
}
}'
# 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 LTX 2.5
Quanto costa l’API di LTX 2.5?
LTX 2.5 costa da 68 crediti (0,68 USD) per una clip di 5 secondi con Crea video, il suo task più economico. Prezzi per opzione: 720p 13,5 crediti al secondo, 1080p 19,5 crediti al secondo, 2K 28,5 crediti al secondo, 4K 45 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 LTX 2.5 nell’API?
Inserisci lightricks/ltx-2.5/text-to-video per Crea video; lightricks/ltx-2.5/image-to-video per Da immagine a video nel campo model di POST /jobs/createTask.
Quanto può durare un clip LTX 2.5?
Da cinque a venti secondi interi in una sola richiesta, su entrambi gli endpoint. Non esiste un’attività di estensione, quindi la durata si decide al momento della generazione e non concatenando clip.
Quali risoluzioni supporta LTX 2.5?
720p, 1080p, 2K e 4K, tutte dalla stessa forma di richiesta. 720p è il valore predefinito. La messa in scena si giudica già a 720p; le fasce più alte comprano texture, trama del tessuto e dettaglio speculare.
LTX 2.5 genera l’audio?
Sì. Le clip tornano con una traccia audio generata anche se nessuno dei due 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.
Quali proporzioni sono disponibili?
Solo 16:9 e 9:16, su text-to-video. Image-to-video non ha affatto un campo aspect_ratio: la forma la decide il fotogramma di apertura. Consegne quadrate o in 4:3 non sono disponibili da questa famiglia.
Posso mandare solo un fotogramma di chiusura?
No. last_image_url è valido solo insieme a image_url. Fissa il punto in cui la ripresa atterra; il movimento tra i due fotogrammi resta generato e su un clip lungo può vagare.
Quali sono i limiti dell’API di LTX 2.5?
Durata della clip: 5–20 s; Risoluzioni: 720p · 1080p · 2K · 4K; Proporzioni: 16:9 · 9:16. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare LTX 2.5 senza scrivere codice?
Sì. Il Playground esegue LTX 2.5 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli LTX
MiniMax H3 copre più formati e aggiunge le foto di riferimento, ma si ferma a 15 secondi. LTX 2.5 è la scelta per i piani da 20 secondi e il 4K nativo.
- API di LTX 2.5Lunghe riprese da 20 secondi fino al 4K, con colonna sonoraDa 68 crediti per una clip di 5 secondi
- API di LTX-2.3 LoRAClip LTX-2.3 con audio stereo e le tue LoRADa 18 crediti per una clip di 5 secondi
- API di LTX-2 19BClip da 20 secondi con voci, musica ed effettiDa 11 crediti per una clip di 5 secondi
- API di LTX-2 19B LoRAClip LTX-2 con audio e i tuoi stili LoRADa 14 crediti per una clip di 5 secondi

