How do I generate a video using grok-imagine-video API?

Invii una richiesta POST con il modello 'grok-imagine-video' includendo un prompt testuale e un'eventuale sorgente immagine/video; viene restituito un ID attività, quindi interroga periodicamente questo ID finché lo stato del video non è 'done'.

What input formats does grok-imagine-video accept?

Accetta un prompt in linguaggio naturale e URL di immagini opzionali (o immagini in base64) per l'animazione; per la modifica si fornisce un URL del video.

What are the maximum video duration and resolution options?

Il modello supporta la generazione di video fino a 15 secondi e risoluzioni fino a 720p, con rapporti d'aspetto configurabili come 16:9 o 1:1.

Can I animate a still image into a video with this model?

Sì, puoi animare un'immagine statica trasformandola in movimento in base al tuo prompt, usando URL di immagini o immagini codificate nella richiesta.

Does grok-imagine-video support editing existing videos?

Sì — fornisci l'URL del video sorgente e le tue istruzioni di modifica; l'output mantiene la durata e la risoluzione del video originale.

How does moderation work in grok-imagine-video outputs?

I video generati sono soggetti a moderazione dei contenuti; i contenuti contrassegnati possono essere filtrati o bloccati durante la generazione.

Is the video generation asynchronous?

Sì, l'API restituisce un ID della richiesta che interroghi periodicamente per verificare quando il video è pronto per il download.

How should I handle expired video URLs?

I video scaricati dovrebbero essere salvati rapidamente; gli URL temporanei possono scadere e diventare inaccessibili dopo la generazione.

API Grok Imagine Video Conveniente | image-to-video

📘 Specifiche tecniche di Grok Imagine Video

Specification	Details
ID modello	grok-imagine-video
Provider	xAI
Tipo	IA per generazione e modifica di video
Tipi di input	Testo (prompt); immagine o video opzionali Prompt testuali (linguaggio naturale); input immagine opzionale (image→video); `video_url` opzionale per modificare clip esistenti. Le durate massime dei video di input per la modifica variano in base all’endpoint — per alcuni flussi di modifica sono stati riportati ~8.7s.
Tipi di output	Video .mp4 tramite URL temporaneo
Intervallo di durata (generazione)	1–15 secondi
Risoluzione	480p, 720p (configurabile)
Proporzioni	1:1, 16:9, 9:16
Supporto alla modifica	Sì — anima e modifica video fino a 8.7s
Moderazione	Moderazione dei contenuti inclusa
Prezzi	Addebitato al secondo, varia in base alla risoluzione

🚀 Che cos’è Grok Imagine Video?

Grok Imagine Video è il modello avanzato di IA di xAI per la generazione e la modifica di video, esposto tramite CometAPI. Consente agli sviluppatori di generare brevi video personalizzati da prompt in linguaggio naturale e, facoltativamente, di animare immagini statiche o modificare clip esistenti. Il modello supporta lunghezza di output, risoluzione e proporzioni configurabili, con moderazione dei contenuti integrata per garantire la conformità alle policy.

🧠Funzionalità principali (cosa distingue Grok Imagine)

Audio nativo + lip-sync: genera audio ambientale sincronizzato, effetti e brevi parlati / narrazioni con sincronizzazione labiale approssimativa.
Image→Video / modifica tramite prompt: anima un’immagine statica o modifica filmati esistenti tramite prompt testuali (rimuovere/sostituire oggetti, ritimizzare, cambiare stile).
Iterazione rapida e bassa latenza: progettato per cicli di feedback rapidi, adatti a flussi di lavoro creativi e prototipazione di prodotto.
API di produzione: l’API Imagine espone endpoint programmatici per generazione in batch, integrazione nelle pipeline di editing e controlli enterprise.
Più “modalità” / stili: modalità rivolte all’utente (esempi riportati: Normal / Fun / Spicy o preset simili) per orientare gli output in termini di stile o permissività (nota: storicamente la modalità “Spicy” consentiva contenuti NSFW).

Model (company)	Max res (public)	Max clip len (public)	Native audio?	Strengths	Caveats
Grok Imagine (xAI)	720p	6–15s	Sì	Iterazione rapida, ottimo rapporto costo/latenza, editing integrato, audio nativo	Limite a 720p; problemi di moderazione; fedeltà variabile nel mondo reale
Sora (OpenAI)	720p–1080p (depends on tier)	short (6–15s)	Sì	Elevata fedeltà visiva; forte integrazione con lo stack OpenAI	Più costoso; moderazione/controlli più vincolati
Veo (Google DeepMind)	Up to 1080p+	short (varies)	Sì	Forte fotorealismo, movimento stabile	Costo più elevato; minore sperimentazione pubblica
Runway Gen-4.5	1080p+	short (varies)	Sì	Adozione nel settore per flussi di lavoro creativi, alta fedeltà	Più costoso; focalizzato sugli strumenti creativi
Vidu / Kling / Pika (various specialists)	up to 1080p	short (varies)	Misto	Alcuni offrono funzionalità di nicchia (Smart Cuts, concatenazione multi-shot)	Supporto audio variabile; diversa maturità delle API

⚠️ Limitazioni

La lunghezza massima del video è limitata a 15 secondi.
La modifica mantiene la lunghezza del video di input (≤ 8.7s).
Gli URL generati sono effimeri — scaricali tempestivamente.

Come accedere e integrare Grok Imagine Video

Passaggio 1: registrarsi per ottenere una chiave API

Accedi a cometapi.com. Se non sei ancora nostro utente, registrati prima. Accedi alla tua console CometAPI. Ottieni la credenziale di accesso, ovvero la chiave API dell’interfaccia. Fai clic su “Add Token” nella sezione API token del centro personale, ottieni la chiave token: sk-xxxxx e inviala.

Passaggio 2: inviare richieste all’API `Grok Imagine Video`

Seleziona l’endpoint “grok-imagine-video” per inviare la richiesta API e imposta il corpo della richiesta. Il metodo di richiesta e il corpo della richiesta si ottengono dalla documentazione API sul nostro sito web. Il nostro sito web fornisce anche test Apifox per tua comodità. Sostituisci <YOUR_API_KEY> con la tua effettiva chiave CometAPI del tuo account. Dove chiamarla: GROKVideo Generation e Video Edit.

Passaggio 3: inviare richieste all’API `Grok Imagine Video`

Inserisci testo o carica un’immagine(Puoi facoltativamente fornire un’immagine sorgente da animare.). L’API Grok Imagine AI analizza il tuo input e prepara il contenuto per l’URL. Sono supportate sia la conversione da testo a video sia quella da immagine a video.

L’immagine sorgente può essere fornita come:

Un URL pubblico che punta a un’immagine
Un data URI codificato in base64( ad esempio, data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

Passaggio 4: recuperare e verificare i risultati

Elabora la risposta API per ottenere l’output generato. Dopo l’elaborazione, l’API risponde con lo stato dell’attività e i dati di output. Restituisce immediatamente un request_id al momento dell’invio; usa l’endpoint GET per controllare lo stato e recuperare il video generato. La modifica video è asincrona, potresti dover interrogare questo endpoint più volte finché l’attività non è completata. Scarica tempestivamente.

Prezzi per Grok Imagine Video

Esplora i prezzi competitivi per Grok Imagine Video, progettato per adattarsi a vari budget e necessità di utilizzo. I nostri piani flessibili garantiscono che paghi solo per quello che usi, rendendo facile scalare man mano che i tuoi requisiti crescono. Scopri come Grok Imagine Video può migliorare i tuoi progetti mantenendo i costi gestibili.

Pricing Overview

Category	Item	Price
Input Pricing	Text	N/A (Free)
	Image	$0.0016
	Video per second	$0.008
Output Pricing	480p	$0.04
(Per second by resolution)	720p	$0.056

Note: When generating video via API, you are charged per second. You will also be charged when using video or images as input.

Codice di esempio e API per Grok Imagine Video

Accedi a codice di esempio completo e risorse API per Grok Imagine Video per semplificare il tuo processo di integrazione. La nostra documentazione dettagliata fornisce una guida passo dopo passo, aiutandoti a sfruttare appieno il potenziale di Grok Imagine Video nei tuoi progetti.

Python
JavaScript
Curl

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("
Step 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

Python Code Example

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("\nStep 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

JavaScript Code Example

// Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
const api_key = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const base_url = "https://api.cometapi.com/grok/v1";

const headers = {
  "Authorization": `Bearer ${api_key}`,
  "Content-Type": "application/json",
};

// ============================================================
// Step 1: Create Video Generation Task
// ============================================================
console.log("Step 1: Creating video generation task...");

const createPayload = {
  model: "grok-imagine-video",
  prompt: "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
  duration: 10,
  aspect_ratio: "16:9",
  resolution: "720p",
};

const createResponse = await fetch(`${base_url}/videos/generations`, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(createPayload),
});

const createResult = await createResponse.json();
console.log("Create response:", JSON.stringify(createResult, null, 2));

const taskId = createResult?.request_id || createResult?.id;
if (!taskId) {
  console.log("Error: Failed to get task ID from response");
  process.exit(1);
}

console.log(`Task ID: ${taskId}`);

// ============================================================
// Step 2: Poll for Task Status
// ============================================================
console.log("\nStep 2: Polling task status...");

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

while (true) {
  const queryResponse = await fetch(`${base_url}/videos/${taskId}`, {
    method: "GET",
    headers: headers,
  });

  const queryResult = await queryResponse.json();
  const data = queryResult?.data || {};
  const status = data?.status || "unknown";
  const progress = data?.progress || "0%";
  console.log(`Status: ${status}, Progress: ${progress}`);

  if (["FAILURE", "failed"].includes(status)) {
    console.log("Video generation failed!");
    console.log(`Reason: ${data?.fail_reason}`);
    process.exit(1);
  }

  if (status === "SUCCESS") {
    const videoUrl = data?.data?.video?.url;
    console.log("Video generation completed!");
    console.log(`Video URL: ${videoUrl}`);
    break;
  }

  await sleep(10000);
}

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"

BASE_URL="https://api.cometapi.com/grok/v1"

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
echo "Step 1: Creating video generation task..."

CREATE_RESPONSE=$(curl -s --location --request POST "${BASE_URL}/videos/generations" \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }')

echo "Create response: $CREATE_RESPONSE"

# Extract task ID using jq (install with: brew install jq)
TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.request_id // .id')

if [ "$TASK_ID" == "null" ] || [ -z "$TASK_ID" ]; then
  echo "Error: Failed to get task ID from response"
  exit 1
fi

echo "Task ID: $TASK_ID"

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
echo ""
echo "Step 2: Polling task status..."

while true; do
  QUERY_RESPONSE=$(curl -s --location --request GET "${BASE_URL}/videos/${TASK_ID}" \
    --header "Authorization: Bearer $COMETAPI_KEY")

  STATUS=$(echo "$QUERY_RESPONSE" | jq -r '.data.status')
  PROGRESS=$(echo "$QUERY_RESPONSE" | jq -r '.data.progress')
  echo "Status: $STATUS, Progress: $PROGRESS"

  if [ "$STATUS" == "FAILURE" ] || [ "$STATUS" == "failed" ]; then
    echo "Video generation failed!"
    echo "$QUERY_RESPONSE" | jq -r '.data.fail_reason'
    exit 1
  fi

  if [ "$STATUS" == "SUCCESS" ]; then
    VIDEO_URL=$(echo "$QUERY_RESPONSE" | jq -r '.data.data.video.url')
    echo "Video generation completed!"
    echo "Video URL: $VIDEO_URL"
    break
  fi

  sleep 10
done