xAI

Grok Imagine 1.5 Lite

grok-imagine-1.5-lite/text-to-video

Livello di generazione video leggero e a basso costo, supporta la generazione video da testo e da immagine, con effetti sonori e dialoghi generati nella stessa sessione, ideale per la produzione in serie ad alta frequenza di brevi video

grok-imagine-1.5-lite/image-to-video grok-imagine-1.5-lite/text-to-video

Prova grok-imagine-1.5-lite/text-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

grok-imagine-1.5-lite/text-to-video per second

Specifiche	Prezzo unitario
480P	$0.029
720P	$0.043
1080P	$0.200

Panoramica del posizionamento

grok-imagine-1.5-lite/text-to-video è un modello leggero di text-to-video pensato per la produzione di contenuti brevi: genera direttamente da un prompt testuale clip video da 1 a 15 secondi, da 480p a 1080p, e supporta formati quali 16:9, 1:1 e 9:16. Punta su velocità di generazione e disponibilità in batch, ed è adatto a sviluppatori che necessitano di produrre con frequenza video brevi per i social, materiali in loop e bozze di storyboard creativi; è richiamabile tramite l'interfaccia unificata di HiAPI.ai.

Punti di forza principali

Dal prompt al video finito in un solo passaggio — basta inviare una descrizione di scena e movimento fino a 4096 caratteri per ottenere il video, senza immagini di riferimento.
Formato e durata regolabili in base alle esigenze — supporta 7 rapporti d'aspetto e durate da 1 a 15 secondi, per allinearsi direttamente a specifiche orizzontali, quadrate o verticali a seconda del canale di distribuzione.
Fatturazione in base ai secondi generati — il criterio di tariffazione è legato alla durata del video, rendendo controllabili i costi della generazione di clip brevi e delle prove in batch.

Descrizione delle capacità

Generazione video guidata dal testo: descrivendo scena e movimento in linguaggio naturale si genera il video; il prompt può arrivare a 4096 caratteri, sufficienti per indicazioni di storyboard piuttosto complete.

Output a più risoluzioni: sono disponibili tre livelli, 480p, 720p e 1080p, così lo stesso modello può coprire dalla preview di una bozza alla consegna del video finito.

Controllo flessibile della durata: la durata è impostabile tra 1 e 15 secondi, con valore predefinito di 6 secondi, adatta sia al ritmo dei video brevi sia a quello dei materiali in loop.

Adattamento a più formati: sono integrati sette rapporti — 16:9, 4:3, 3:2, 1:1, 2:3, 3:4 e 9:16 — con 16:9 predefinito, che corrispondono direttamente ai diversi spazi di visualizzazione.

Scenari d'uso

Creatori di contenuti social che generano clip verticali — inserendo la descrizione della scena e scegliendo il formato 9:16 si ottengono materiali video brevi pronti per il feed.
Team di design che preparano bozze di storyboard creativi — descrivendo a parole inquadrature e movimenti si generano clip a bassa risoluzione per la validazione dei concept e le discussioni progettuali.
Professionisti del marketing che producono materiali in batch — generando in batch clip brevi con prompt e formati diversi per test rapidi e selezione dei materiali pubblicitari.

Limiti e consigli per la scelta

Essendo un modello di fascia Lite, la qualità dell'immagine e la fedeltà dei dettagli sono inferiori alla versione completa, e l'output a 1080p deriva da un upscaling di un rendering a 720p, con una nitidezza effettiva limitata. La durata massima per singola generazione è di 15 secondi, non supporta personaggi di riferimento multipli né il controllo della scena, e non è adatto a narrazioni video lunghe o a progetti che richiedono una precisa coerenza dei personaggi; quando la qualità dell'immagine è una priorità, conviene passare alla versione completa o ad altri modelli video di specifiche superiori.

Domande frequenti

Vedi tutte le domande →

Ogni video ha l'audio?

Sì. L'audio viene generato insieme alle immagini e non può essere disattivato. Puoi descrivere nel prompt i suoni ambientali, la musica o i dialoghi che desideri.
Quali durate, risoluzioni e proporzioni di aspetto sono supportate?

Durata da 1 a 15 secondi come numero intero (predefinito 6 secondi); risoluzioni 480p, 720p, 1080p (predefinita 720p); proporzioni di aspetto 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 (predefinita 16:9).
Quanto può essere lungo al massimo il prompt?

Massimo 4096 caratteri. Una descrizione concentrata su soggetto, azione, inquadratura e audio di solito funziona meglio di una lunga serie di parole chiave.
Posso usare questo modello per animare le mie immagini?

No, questa linea accetta solo testo. Se devi partire dalla tua immagine, usa grok-imagine-1.5-lite/image-to-video.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: grok-imagine-1.5-lite/text-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per grok-imagine-1.5-lite/text-to-video e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1maxLength 4096

Descrivi la scena visiva e l'effetto dinamico desiderato; è l'input principale per la generazione di video da testo, supporta fino a 4096 caratteri.

durationintegerOpzionalePredefinito: 6min 1max 15

Durata del video di output, in secondi, intervallo di valori 1-15, predefinito 6 secondi.

resolutionstringOpzionalePredefinito: "720p"

Risoluzione del video di output, controlla la nitidezza dell'immagine generata, predefinita 720p.

Opzioni:480p720p1080p

aspect_ratiostringOpzionalePredefinito: "16:9"

Proporzioni di aspetto del video di output, controlla il formato proporzionale dell'immagine generata, predefinito 16:9.

Opzioni:16:94:33:21:12:33:49:16

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -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-lite/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-1.5-lite/text-to-video",
    input: {
      "prompt": "…",
      "duration": 6,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-1.5-lite/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 6,
          "resolution": "720p",
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}