Grok Imagine 1.5 API: trasforma le immagini in brevi video

Una singola foto di prodotto, un ritratto o un fotogramma fermo di un paesaggio possono diventare una breve clip video utilizzabile senza dover accedere a un altro account per la generazione video. L'endpoint image-to-video di Grok Imagine 1.5 accetta un URL immagine, un prompt opzionale che descrive il movimento e una durata, quindi restituisce il file .mp4 renderizzato tramite l'API asincrona delle attività di hiapi.

Questa guida pratica utilizza la stessa immagine sorgente e due prompt diversi per mostrare quanto la formulazione possa cambiare il risultato, poi analizza lo schema effettivo della richiesta, i prezzi e fornisce esempi di codice pronti da copiare.

Immagine sorgente

Entrambe le clip seguenti partono da questo stesso fotogramma fermo. Tra le due richieste, l'immagine di base non cambia in alcun modo: solo il campo prompt è diverso.

Versione 1: panoramica breve in stile teaser

Prompt: "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing." Durata: 4.

Versione 2: ripresa orbitale più lunga

Prompt: "Camera slowly orbits around the subject, revealing the scene from a new angle." Durata: 8.

Stesso fotogramma fermo, stesso modello, due movimenti di camera completamente diversi: qui è quasi tutto merito del prompt, perché nella richiesta non ci sono parametri specifici per l'intensità del movimento o il percorso della camera.

Lo schema effettivo della richiesta

La documentazione completa del modello e i prezzi aggiornati sono disponibili nella pagina del modello image-to-video di Grok Imagine 1.5. Il corpo della richiesta è volutamente essenziale:

{
  "model": "grok-imagine-1.5/image-to-video",
  "input": {
    "image_urls": ["https://your-public-host.com/source.jpg"],
    "prompt": "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.",
    "duration": 4
  }
}

Tre cose da sapere prima di effettuare la chiamata:

• image_urls deve essere un URL HTTP(S) pubblico. Il modello recupera l'immagine da solo: non è possibile caricare i byte grezzi nel corpo della richiesta. Se l'immagine sorgente esiste solo in locale, caricala prima su un bucket pubblico qualsiasi.
• duration è un numero intero da 1 a 15 secondi. Non esistono campi aspect_ratio, resolution o intensità del movimento: la composizione dell'output segue l'immagine sorgente, mentre la risoluzione è determinata dal livello di prezzo (480p o 720p), non da un parametro della richiesta.
• prompt è opzionale, ma svolge la maggior parte del lavoro creativo, perché oltre a esso non c'è altro che possa guidare la camera.

Inviare e monitorare l'attività

Come tutti i modelli video e immagine su hiapi, questo modello funziona tramite l'API asincrona unificata delle attività, non tramite un endpoint sincrono: la generazione richiede tempo reale, quindi devi inviare l'attività, monitorarne il completamento e poi scaricare il risultato prima che il link scada.

# 1. Submit the task
curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5/image-to-video",
    "input": {
      "image_urls": ["https://your-public-host.com/source.jpg"],
      "prompt": "Camera slowly orbits around the subject, revealing the scene from a new angle.",
      "duration": 8
    }
  }'
# => {"id": "task_...", "status": "pending"}

# 2. Poll until it's done
curl -s https://api.hiapi.ai/v1/tasks/task_... \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# => {"id": "task_...", "status": "success", "output": [{"url": "https://...mp4"}]}

Non appena status diventa success, scarica immediatamente output[0].url: è un link a tempo, non permanente, quindi salva i byte nel tuo archivio prima che scada.

Prezzi e calcolo della durata

Prima di fare un preventivo per attività in batch, verifica i dati attuali sulla pagina dei prezzi di hiapi, ma al momento della stesura di questo articolo, grok-imagine-1.5/image-to-video viene fatturato al secondo di output:

Risoluzione	Prezzo al secondo
480p	$0.015
720p	$0.0282

Una clip di 4 secondi a 480p costa $0.06; la stessa clip a 720p costa circa $0.11. Poiché il prezzo scala con la durata e non con un costo fisso per generazione, testare più varianti di prompt sulla stessa immagine ferma prima di definire il montaggio finale costa poco: le due clip di questo articolo costano complessivamente molto meno di $0.20.

Domande frequenti

Posso controllare direttamente il movimento della camera invece di descriverlo nel prompt? No: lo schema di questo endpoint non include parametri specifici per intensità del movimento, percorso della camera o zoom. Il comportamento della camera dipende interamente da come formuli il prompt.

La risoluzione dell'output corrisponderà alla mia immagine sorgente? La composizione segue le proporzioni dell'immagine sorgente, ma la risoluzione (480p o 720p) è una scelta del livello di prezzo, non impostata tramite un campo separato: consulta lo schema attuale sulla pagina del modello linkata sopra, poiché i modelli della piattaforma aggiungono occasionalmente parametri.

Cosa succede se non scarico l'output abbastanza velocemente? L'output[0].url di un'attività completata è a tempo. Se perdi la finestra, devi reinviare l'attività e pagare di nuovo il costo della generazione: non è possibile recuperare un link scaduto.

Posso animare più fotogrammi fermi in un'unica richiesta? image_urls accetta un URL, ma ogni attività genera una clip da una sola immagine sorgente. Per attività in batch, invia un'attività per ogni fotogramma fermo e monitorale separatamente: il modello asincrono significa che puoi avere più attività in corso contemporaneamente.

---

Pronto a provarlo sulle tue immagini? Genera una breve clip con i tuoi prompt nella pagina del modello image-to-video di Grok Imagine 1.5, oppure, se devi integrarlo in una pipeline esistente, inizia dalla documentazione dell'API asincrona delle attività.