grok-imagine-video

Grok Imagine Video crea brevi video da una descrizione testuale, con scelta della durata e delle proporzioni dell'inquadratura. Il modello di xAI stesso supporta anche animazione di immagini e modifica mirata di video.

Ailoot · Generazione video POST /v1/videos/generations grok-imagine-video

Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

Dalla descrizione al video

Grok Imagine Video crea video da testo. Il modello di xAI stesso dispone anche di modalità con un'immagine o un video iniziale. Nel metodo di generazione pubblicato da Ailoot, l'input è una descrizione testuale e il risultato un video.

La generazione viene eseguita in modo asincrono: si crea prima un'attività, poi se ne ottengono stato e risultato finale tramite l'identificatore. Secondo xAI, creare un video può richiedere diversi minuti; il tempo dipende da complessità della scena, durata, risoluzione e modalità scelta.

Durata e inquadratura

Per creare un video è disponibile una durata da 1 a 15 secondi. I formati dell'inquadratura comprendono 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 e 2:3; il formato standard è 16:9. Questa versione prevede 480p e 720p, mentre 1080p appartiene alla versione 1.5.

Animazione dell'immagine iniziale

Nella modalità di xAI con un'immagine, questa diventa il fotogramma iniziale e l'istruzione testuale definisce il movimento. Per impostazione predefinita, la forma del video ripete le proporzioni dell'immagine iniziale. Proporzioni definite esplicitamente cambiano questa forma e possono deformare l'immagine.

Modifica mirata

Quando lavora su un video già pronto, il modello applica i cambiamenti descritti conservando il resto del contenuto della scena. Questa modalità aiuta a modificare un elemento specifico mantenendo la regia del video originale. Durata e proporzioni vengono ereditate dall'originale; non si impostano una nuova durata né una nuova forma dell'inquadratura.

Il video iniziale per la modifica è limitato a 8,7 secondi e il risultato a una risoluzione non superiore a 720p. Il materiale in 1080p viene ridotto a 720p. Le impostazioni della generazione da testo non si trasferiscono automaticamente alla modifica.

Continuazione di un video pronto

In una modalità separata di xAI, questa versione prosegue un video iniziale dal suo ultimo fotogramma. L'MP4 originale deve durare da 2 a 15 secondi; la parte aggiunta da 2 a 10 secondi, con 6 come valore predefinito. Il risultato unisce video originale e continuazione. Proporzioni e risoluzione vengono ereditate dall'originale, con un limite di 720p; non possono essere modificate separatamente in questa modalità. Questa capacità del produttore è diversa dalla generazione di Ailoot pubblicata da testo.

Riferimenti e limiti della versione

xAI prevede l'uso di riferimenti visivi per guidare l'aspetto di persone, abiti e oggetti nella scena. Un riferimento definisce caratteristiche visive, non un'immagine esatta del primo fotogramma. Per il classico Grok Imagine Video non si può combinare un fotogramma iniziale con riferimenti.

Questa versione non accetta il vincolo esatto dell'ultimo fotogramma né fotogrammi chiave intermedi. Queste capacità appartengono a Grok Imagine Video 1.5. Generazione, animazione di un'immagine iniziale e modifica di un video pronto sono modalità diverse; il metodo Ailoot pubblicato qui descrive la generazione da testo.

Ailoot · Generazione video POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Introduzione

Input accettati: Testo
Risultati: Video

Disponibile in Ailoot · input e metodi

Ailoot · Generazione video POST /v1/videos/generations

Tipi di input: text
Tipi di output: video
Formato di output: mp4

Campo	Tipo	Requisito	Valori e limiti	Predefinito
Campo`model`	Tipo`string`	RequisitoObbligatorio	Valori e limiti grok-imagine-video	Predefinito—
Campo`prompt`	Tipo`string`	RequisitoFacoltativo	Valori e limiti Lunghezza minima: 1	Predefinito—
Campo`duration`	Tipo`integer`	RequisitoFacoltativo	Valori e limiti Minimo: 1 Massimo: 15 Condizioni: Non fornire sia duration sia seconds Unità: secondi	Predefinito1
Campo`seconds`	Tipo`integer\|integer_string`	RequisitoFacoltativo	Valori e limiti Minimo: 1 Massimo: 15 Alternativa: duration	Predefinito—
Campo`resolution`	Tipo`string`	RequisitoFacoltativo	Valori e limiti 480p, 720p	Predefinito480p
Campo`aspect_ratio`	Tipo`string`	RequisitoFacoltativo	Valori e limiti 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Condizioni: Se viene fornita un'immagine in ingresso e viene omesso il rapporto d'aspetto, il fornitore eredita quello dell'immagine	Predefinito16:9
Campo`size`	Tipo`string`	RequisitoFacoltativo	Valori e limiti 1280x720, 720x1280, 1920x1080, 1080x1920 Condizioni: Deve coincidere con resolution/aspect_ratio se entrambi sono specificati	Predefinito—
Campo`image`	Tipo`object`	RequisitoFacoltativo	Valori e limiti Condizioni: Immagine in ingresso reale e supportata; consente di omettere il prompt	Predefinito—

Combinazioni di materiali in input

Da testo a video · Obbligatorio: prompt

Da immagine a video · Obbligatorio: image

Parametri e ciclo di vita del metodo

Parametro	Contratto
Parametro`material_types`	Contrattotext
Parametro`required`	Contrattonull
Parametro`optional_controls`	Contrattonull

Ciclo di vita: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.

Tariffe

Tariffe dei metodi Ailoot

Ailoot Generazione videoPOST /v1/videos/generations

Input: 0,002 USD per immagine in input
Input: 0,01 USD per secondo di video in input
Output: 0,05 USD per secondo a 480p
Output: 0,07 USD per secondo a 720p

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →

Esempi di richieste

Ailoot · Generazione video

Esempio video

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Ricevi e salva i risultati

Ailoot · Generazione video

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Verifica lo stato dell’attività

GET stato

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

Altre letture di contenuto

GET contenuto

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

Conserva tutti i risultati completati

Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.

Conserva il JSON completo dello stato e il request_id effettivo. Una risposta completata con status=done contiene video.url con un URL del contenuto di tua proprietà. Preserva la durata riportata e ogni campo del risultato restituito.

Se occorre verificare la risposta originale

Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.

Campi della risposta

Campo	Tipo
Campo`request_id`	Tipostring
Campo`id`	Tipostring
Campo`status`	Tipostring
Campo`video.url`	Tipoowned signed content URL
Campo`video.duration`	Tiponumber
Campo`video.respect_moderation`	Tipoboolean

Errori e passaggi successivi

Risposta	Condizione	Passaggio successivo
Risposta400 · `invalid_request_error`	CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi	Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione.
Risposta409 · `video_not_ready`	CondizioneContenuto del risultato originale non ancora disponibile	Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After.
Risposta`server_error`	CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica	Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione.

Alias

Alias del modello

Ailoot grok-imagine-video

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

grok-imagine-video

FAQ · grok-imagine-video

Quali input e risultati sono disponibili?: POST /v1/videos/generations · grok-imagine-video: text → video
Quali campi usa la richiesta?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Quali limiti si applicano?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video