Przejdź do treści

Mage API · Model wideo

Grok Video API

Grok Imagine w ruchu

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.

  • WideoWynik
  • 1Wariant
  • 375Gems za klip, domyślnie
  • $0.375Około, w USD

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

  • Wideo źródłowe może mieć najwyżej 8,7 sekundy i nie można łączyć go z obrazami referencyjnymi.
  • Do 5 obrazów referencyjnych, które ograniczają klip do 10 sekund.

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 1856 Gems

    Magejutsu API

    Zmień obsadę dowolnego wideo, zachowując jego ruch

  • Wideo · od 147 Gems

    Melon API

    Anime w ruchu, opcjonalnie z dźwiękiem

  • Wideo · od 45 Gems

    MiniMax-H3 API

    Szybkie otwarte wideo z dźwiękiem stereo

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.

CharactersSpołeczność