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.
Wideo
Wynik
1
Wariant
375
Gems za klip, domyślnie
$0.375
Okoł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_id | Nazwa | Domyślny |
|---|---|---|
| grok-imagine-video | Grok Video | Tak |
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.
| Pole | Wartości |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 |
| resolution | 480p, 720p |
| duration | 1, 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.
| Pole | Rola |
|---|---|
| image | Obraz referencyjny. |
| additional_images | Dodatkowe 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 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.