API Grok Video

In breve

L'API Grok Video esegue Grok Video tramite Mage su POST https://api.mage.space/v1/grok_video/generate. Una richiesta con le impostazioni predefinite costa 375 Gems (circa 0,375 $), senza abbonamento. Grok Video usa personaggi e riferimenti salvati tramite @handle nel prompt.

• Video

  Output

• 1

  Variante

• 375

  Gems per clip, predefinito

• $0.375

  Circa, in USD

Panoramica

Cosa fa l'API Grok Video

Grok Imagine di xAI per i video, a partire da un testo, fino a 5 riferimenti o una breve clip di partenza. Da 1 a 15 secondi fino a 720p. Si applica il filtro di sicurezza di xAI.

Grok Imagine di xAI per i video, a partire da un testo, immagini di riferimento o un video di partenza da modificare. Si applica il filtro di sicurezza di xAI.

Accetta image, additional_images, video come input.

Guida rapida

Chiama l'API Grok Video

Imposta MAGE_API_KEY, invia a /grok_video/generate e interroga status_url finché la richiesta non è completata.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_video/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "5",
  "model_id": "grok-imagine-video"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('grok_video', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'grok-imagine-video',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("grok_video", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "grok-imagine-video",
})

print(request["result"]["url"])

Modelli

Valori model_id di Grok Video

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

Opzioni

Parametri di Grok Video

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

Input

Input multimediali accettati da Grok Video

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

Regole

Cosa impone l'API Grok Video

• Un video di partenza può durare al massimo 8,7 secondi e non può essere combinato con immagini di riferimento.
• Fino a 5 immagini di riferimento, che limitano la clip a 10 secondi.

Altri modelli video

Altre API per generare video su Mage

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• API per la generazione di video con AI
• Riferimento della API di Grok Video
• Playground di Grok Video
• Tutti i modelli API
• Server MCP di Mage