Přeskočit na obsah

Mage API · Model pro video

Grok Video API

Grok Imagine v pohybu

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

Stručně

Grok Video API spouští Grok Video přes Mage na POST https://api.mage.space/v1/grok_video/generate. Požadavek s výchozím nastavením stojí 375 Gems (asi 0,375 $), bez předplatného. Grok Video bere uložené postavy a reference přes @handle v promptu.

  • VideoVýstup
  • 1Varianta
  • 375Gems za klip, výchozí
  • $0.375Přibližně v USD

Přehled

Co umí Grok Video API

Grok Imagine od xAI pro video z textu, až 5 referencí nebo krátkého zdrojového klipu. 1 až 15 sekund až v rozlišení 720p. Platí bezpečnostní filtr xAI.

Grok Imagine od xAI pro video z textu, referenčních obrázků nebo zdrojového videa k úpravě. Platí bezpečnostní filtr xAI.

Jako vstup přijímá image, additional_images, video.

Rychlý start

Zavolej Grok Video API

Nastav MAGE_API_KEY, odešli požadavek na /grok_video/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Grok Video

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
grok-imagine-videoGrok VideoAno

Možnosti

Parametry Grok Video

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
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

Vstupy

Mediální vstupy, které Grok Video přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.
videoZdrojové video.

Pravidla

Co Grok Video API vynucuje

  • Zdrojové video může mít nanejvýš 8,7 sekundy a nelze ho kombinovat s referenčními obrázky.
  • Až 5 referenčních obrázků, kvůli kterým je klip omezený na 10 sekund.

Další video modely

Další API pro generování videa na Mage

  • Video · od 270 Gems

    Kiwi API

    Každodenní video bez nastavování

  • Video · od 245 Gems

    Lemon API

    Všechny video funkce za příznivější cenu

  • Video · od 20 Gems

    LTX Video API

    Rychlé video s otevřenými váhami pro iterace

  • Video · od 147 Gems

    Melon API

    Anime v pohybu, volitelně se zvukem

  • Video · od 30 Gems

    MiniMax-H3 API

    Rychlé open video se stereo zvukem

  • Video · od 338 Gems

    Plum API

    Zvuk ke každému klipu, až do 2K

Časté dotazy

Často kladené otázky

Kolik stojí Grok Video API?
Požadavek na Grok Video s výchozím nastavením (Grok Video) stojí 375 Gems, tedy asi 0,375 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Za neúspěšné generování se Gems vrací, za generování zablokované pravidly obsahu Mage ne.
Jaký je endpoint Grok Video API?
POST https://api.mage.space/v1/grok_video/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém se průběžně dotazuješ na výsledek.
Které modely Grok Video můžu volat?
grok-imagine-video (Grok Video). Výchozí je Grok Video.
Podporuje Grok Video referenční obrázky nebo postavy?
Grok Video přijímá image, additional_images, video. Uložené postavy a reference bere přes @handle v promptu.
Můžu používat Grok Video z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Grok Video jménem. Asistent si přečte jeho možnosti přes get_model a před generováním ti sdělí cenu.
Jak dlouho se uchovávají výsledky z Grok Video?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.