Ugrás a tartalomhoz

Mage API · Videómodell

Grok Video API

A Grok Imagine mozgásban

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

Dióhéjban

A Grok Video API a Mage-en keresztül futtatja a Grok Videót a POST https://api.mage.space/v1/grok_video/generate végponton. Egy kérés az alapbeállításokkal 375 Gembe kerül (kb. 0,375 $), előfizetés nélkül. A Grok Video a mentett karaktereket és referenciákat a promptban megadott @handle alapján veszi.

  • VideóKimenet
  • 1Változat
  • 375Gems klipenként, alapértelmezett
  • $0.375Körülbelül, USD-ben

Áttekintés

Mire jó a Grok Video API

Az xAI Grok Imagine modellje videóhoz: szövegből, legfeljebb 5 referenciából vagy egy rövid forrásklipből. 1–15 másodperc, legfeljebb 720p felbontásban. Az xAI biztonsági szűrője érvényes.

Az xAI Grok Imagine modellje videóhoz: szövegből, referenciaképekből vagy szerkeszthető forrásvideóból. Az xAI biztonsági szűrője érvényes.

Bemenetként az image, additional_images, video mezőket fogadja.

Gyors kezdés

A Grok Video API hívása

Állítsd be a MAGE_API_KEY-t, küldd el a kérést a /grok_video/generate végpontra, és kérdezd le a status_url címet, amíg a kérés le nem fut.

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"])

Modellek

Grok Video model_id értékek

Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.

model_idNévAlapértelmezett
grok-imagine-videoGrok VideoIgen

Beállítások

Grok Video paraméterek

Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.

MezőÉrtékek
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

Bemenetek

A Grok Video által fogadott médiabemenetek

Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.

MezőSzerep
imageA referenciakép.
additional_imagesTovábbi referenciaképek.
videoA forrásvideó.

Szabályok

Mit ír elő a Grok Video API

  • A forrásvideó legfeljebb 8,7 másodperces lehet, és nem kombinálható referenciaképekkel.
  • Legfeljebb 5 referenciakép, ami 10 másodpercben korlátozza a klip hosszát.

További videómodellek

További videógeneráló API-k a Mage-en

  • Videó · 270 Gemtől

    Kiwi API

    Hétköznapi videók, beállítás nélkül

  • Videó · 245 Gemtől

    Lemon API

    Minden videófunkció, barátibb áron

  • Videó · 20 Gemtől

    LTX Video API

    Gyors, nyílt súlyozású videómodell a finomhangoláshoz

  • Videó · 147 Gemtől

    Melon API

    Anime mozgásban, opcionális hanggal

  • Videó · 30 Gemtől

    MiniMax-H3 API

    Gyors, nyílt videómodell sztereó hanggal

  • Videó · 338 Gemtől

    Plum API

    Hang minden klipen, akár 2K-ig

GYIK

Gyakran ismételt kérdések

Mennyibe kerül a Grok Video API?
Egy Grok Video-kérés az alapbeállításokkal (Grok Video) 375 Gembe kerül, ez kb. 0,375 dollár. Más felbontás, hossz vagy változat módosítja az árat; a válasz a pontos díjat is megadja. A sikertelen generálást visszatérítjük; azt viszont nem, amelyet a Mage tartalmi irányelvei blokkolnak.
Mi a Grok Video API végpontja?
POST https://api.mage.space/v1/grok_video/generate, a Mage API-kulcsodat tartalmazó Authorization: Bearer fejléccel. A válasz tartalmaz egy status_url-t, amelyet lekérdezve megkapod az eredményt.
Mely Grok Video modelleket hívhatom meg?
grok-imagine-video (Grok Video). Az alapértelmezett a Grok Video.
Támogatja a Grok Video a referenciaképeket vagy a karaktereket?
A Grok Video az image, additional_images, video bemeneteket fogadja el. A mentett karaktereket és referenciákat a promptban @handle-lel adhatod meg.
Használhatom a Grok Videót Claude-ból vagy ChatGPT-ből?
Igen. Csatlakoztasd a Mage MCP-szervert a Claude-hoz, a ChatGPT-hez, a Claude Code-hoz, a Grokhoz vagy a Cursorhoz, és kérd név szerint a Grok Videót. Az asszisztensed a get_model segítségével olvassa ki a beállításokat, és generálás előtt megmondja az árat.
Mennyi ideig maradnak meg a Grok Video eredményei?
Az eredményeket és a bemeneteket 30 napig őrizzük. Amit meg szeretnél tartani, töltsd le a saját tárhelyedre.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.