Treci la conținut

API Mage · Model video

Grok Video API

Grok Imagine, în mișcare

POST https://api.mage.space/v1/grok_video/generate

Pe scurt

Grok Video API rulează Grok Video prin Mage la POST https://api.mage.space/v1/grok_video/generate. O cerere cu setările implicite costă 375 Gems (aproximativ $0.375), fără abonament. Grok Video acceptă personaje salvate și referințe prin @handle în prompt.

  • VideoRezultat
  • 1Variantă
  • 375Gems per clip, implicit
  • $0.375Aproximativ, în USD

Prezentare generală

Ce face Grok Video API

Grok Imagine de la xAI pentru video, pornind de la text, până la 5 referințe sau un clip sursă scurt. De la 1 la 15 secunde, până la 720p. Se aplică filtrul de siguranță xAI.

Grok Imagine de la xAI pentru video, pornind de la text, imagini de referință sau un videoclip sursă de editat. Se aplică filtrul de siguranță xAI.

Acceptă image, additional_images, video ca intrări.

Pornire rapidă

Apelează Grok Video API

Setează MAGE_API_KEY, trimite cererea la /grok_video/generate și interoghează status_url până când cererea se finalizează.

cURL
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"
TypeScript
// 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);
Python
# 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"])

Modele

Valori model_id pentru Grok Video

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
grok-imagine-videoGrok VideoDa

Opțiuni

Parametrii Grok Video

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
resolution480p, 720p
duration1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Intrări

Intrări media acceptate de Grok Video

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.
videoVideoclipul sursă.

Reguli

Ce impune Grok Video API

  • Un videoclip sursă poate avea cel mult 8,7 secunde și nu poate fi combinat cu imagini de referință.
  • Până la 5 imagini de referință, care limitează clipul la 10 secunde.

Mai multe modele video

Alte API-uri de generare video pe Mage

  • Video · de la 270 Gems

    Kiwi API

    Video de zi cu zi, fără configurare

  • Video · de la 245 de Gems

    API Lemon

    Toate funcțiile video, la un preț mai prietenos

  • Video · de la 20 Gems

    LTX Video API

    Video rapid cu open-weights, pentru iterații

  • Video · de la 147 Gems

    Melon API

    Anime în mișcare, cu sunet opțional

  • Video · de la 30 Gems

    MiniMax-H3 API

    Video open rapid cu sunet stereo

  • Video · de la 338 de Gems

    API Plum

    Sunet pe fiecare clip, până la 2K

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Grok Video?
O cerere Grok Video cu setările implicite (Grok Video) costă 375 de Gems, aproximativ 0,375 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpointul API-ului Grok Video?
POST https://api.mage.space/v1/grok_video/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi periodic pentru a obține rezultatul.
Ce modele Grok Video pot apela?
grok-imagine-video (Grok Video). Modelul implicit este Grok Video.
Grok Video acceptă imagini de referință sau personaje?
Grok Video acceptă image, additional_images, video. Grok Video folosește personajele salvate și referințele prin @handle în prompt.
Pot folosi Grok Video din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Grok Video pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte de a genera.
Cât timp sunt păstrate rezultatele Grok Video?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.