Mage API · Model wideo

Grok Video API

Grok Imagine w ruchu

Zdobądź klucz APIWypróbuj Grok Video w playground
POST https://api.mage.space/v1/grok_video/generate

W skrócie

Grok Video API uruchamia Grok Video przez Mage pod adresem POST https://api.mage.space/v1/grok_video/generate. Zapytanie z domyślnymi ustawieniami kosztuje 375 Gems (ok. 0,375 USD), bez subskrypcji. Grok Video przyjmuje zapisane postacie i referencje podawane w prompcie przez @handle.

Przegląd

Co robi Grok Video API

Grok Imagine od xAI do wideo: z tekstu, do 5 referencji lub krótkiego klipu źródłowego. Od 1 do 15 sekund w rozdzielczości do 720p. Obowiązuje filtr bezpieczeństwa xAI.

Grok Imagine od xAI do wideo: z tekstu, obrazów referencyjnych lub wideo źródłowego do edycji. Obowiązuje filtr bezpieczeństwa xAI.

Przyjmuje jako dane wejściowe: image, additional_images, video.

Szybki start

Wywołaj Grok Video API

Ustaw MAGE_API_KEY, wyślij zapytanie do /grok_video/generate i odpytuj status_url, aż zapytanie się zakończy.

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

Wartości model_id dla Grok Video

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
grok-imagine-videoGrok VideoTak

Opcje

Parametry Grok Video

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
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

Dane wejściowe

Pliki multimedialne akceptowane przez Grok Video

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.
videoŹródłowe wideo.

Zasady

Jakie ograniczenia stosuje Grok Video API

Więcej modeli wideo

Inne API do generowania wideo w Mage

Wideo · od 270 Gems

Kiwi API

Wideo na co dzień, bez konfiguracji

Wideo · od 245 Gems

Lemon API

Wszystkie funkcje wideo w bardziej przyjaznej cenie

Wideo · od 20 Gems

LTX Video API

Szybkie wideo z otwartymi wagami do iteracji

Wideo · od 147 Gems

Melon API

Anime w ruchu, opcjonalnie z dźwiękiem

Wideo · od 30 Gems

MiniMax-H3 API

Szybkie otwarte wideo z dźwiękiem stereo

Wideo · od 338 Gems

Plum API

Dźwięk w każdym klipie, do 2K

FAQ

Najczęściej zadawane pytania

Ile kosztuje Grok Video API?

Zapytanie do Grok Video z ustawieniami domyślnymi (Grok Video) kosztuje 375 Gems, czyli ok. 0,375 $. Inne rozdzielczości, czas trwania i warianty zmieniają cenę, a dokładną kwotę podaje odpowiedź. Za nieudaną generację zwracamy Gems, ale nie za tę, którą zablokuje polityka treści Mage.

Jaki jest endpoint Grok Video API?

POST https://api.mage.space/v1/grok_video/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.

Jakie modele Grok Video mogę wywoływać?

grok-imagine-video (Grok Video). Domyślny to Grok Video.

Czy Grok Video obsługuje obrazy referencyjne lub postacie?

Grok Video przyjmuje image, additional_images, video. Zapisane postacie i referencje wywołasz w prompcie przez @handle.

Czy mogę używać Grok Video w Claude lub ChatGPT?

Tak. Podłącz serwer Mage MCP do Claude, ChatGPT, Claude Code, Grok lub Cursora i poproś o Grok Video po nazwie. Asystent odczyta dostępne opcje przez get_model i poda cenę przed generowaniem.

Jak długo przechowywane są wyniki Grok Video?

Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Zdobądź klucz APIWypróbuj Grok Video w playground

Powiązane