Ga naar de inhoud

Mage API · Videomodel

Grok Video API

Grok Imagine in beweging

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

In één oogopslag

De Grok Video API draait Grok Video via Mage op POST https://api.mage.space/v1/grok_video/generate. Een verzoek met de standaardinstellingen kost 375 Gems (ongeveer $0,375), zonder abonnement. Grok Video gebruikt opgeslagen personages en referenties via @handle in de prompt.

  • VideoUitvoer
  • 1Variant
  • 375Gems per clip (standaard)
  • $0.375Ongeveer, in USD

Overzicht

Wat de Grok Video API doet

Grok Imagine van xAI voor video, vanuit tekst, maximaal 5 referenties of een korte bronclip. 1 tot 15 seconden in maximaal 720p. Het veiligheidsfilter van xAI is van toepassing.

Grok Imagine van xAI voor video, vanuit tekst, referentie-afbeeldingen of een bronvideo die je wilt bewerken. Het veiligheidsfilter van xAI is van toepassing.

Het accepteert image, additional_images en video als invoer.

Snel starten

De Grok Video API aanroepen

Stel MAGE_API_KEY in, verstuur naar /grok_video/generate en poll status_url totdat het verzoek is voltooid.

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

Modellen

Grok Video model_id-waarden

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

model_idNaamStandaard
grok-imagine-videoGrok VideoJa

Opties

Grok Video-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

VeldWaarden
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

Invoer

Media-invoer die Grok Video accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
imageDe referentieafbeelding.
additional_imagesExtra referentieafbeeldingen.
videoDe bronvideo.

Regels

Wat de Grok Video API afdwingt

  • Een bronvideo mag maximaal 8,7 seconden duren en kan niet worden gecombineerd met referentie-afbeeldingen.
  • Maximaal 5 referentie-afbeeldingen, waarmee de clip beperkt wordt tot 10 seconden.

Meer videomodellen

Andere API's voor videogeneratie op Mage

  • Video · vanaf 270 Gems

    Kiwi API

    Video voor elke dag, zonder setup

  • Video · vanaf 245 Gems

    Lemon API

    Alle videofuncties, tegen een vriendelijkere prijs

  • Video · vanaf 20 Gems

    LTX Video API

    Snelle open-weights video om mee te itereren

  • Video · vanaf 1.856 Gems

    Magejutsu API

    Geef elke video een nieuwe cast, met behoud van de beweging

  • Video · vanaf 147 Gems

    Melon API

    Anime in beweging, met optionele audio

  • Video · vanaf 45 Gems

    MiniMax-H3 API

    Snelle open video met stereogeluid

FAQ

Veelgestelde vragen

Wat kost de Grok Video API?
Een Grok Video-verzoek met de standaardinstellingen (Grok Video) kost 375 Gems, ongeveer $0,375. Andere resoluties, duurtes en varianten veranderen de prijs; in de respons staat het exacte bedrag. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Grok Video API?
POST https://api.mage.space/v1/grok_video/generate met een Authorization: Bearer-header met je Mage API-sleutel. De respons bevat een status_url die je kunt pollen voor het resultaat.
Welke Grok Video-modellen kan ik aanroepen?
grok-imagine-video (Grok Video). De standaard is Grok Video.
Ondersteunt Grok Video referentie-afbeeldingen of Characters?
Grok Video accepteert image, additional_images en video. Opgeslagen Characters en referenties gebruik je met @handle in de prompt.
Kan ik Grok Video gebruiken vanuit Claude of ChatGPT?
Ja. Koppel de Mage MCP-server aan Claude, ChatGPT, Claude Code, Grok of Cursor en vraag op naam naar Grok Video. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.
Hoe lang worden Grok Video-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

CharactersCommunity