Bir bakışta
Grok Video API, Grok Video'yu Mage üzerinden POST https://api.mage.space/v1/grok_video/generate adresinde çalıştırır. Varsayılan ayarlarla bir istek 375 Gems (yaklaşık $0.375) tutar, abonelik gerekmez. Grok Video, kayıtlı karakterleri ve referansları prompt içinde @handle ile alır.
Video
Çıktı
1
Varyant
375
Klip başına Gems, varsayılan
$0.375
Yaklaşık, USD
Genel bakış
Grok Video API ne yapar?
xAI'ın video için geliştirdiği Grok Imagine; metinden, en fazla 5 referanstan veya kısa bir kaynak klipten video üretir. 720p'ye kadar çözünürlükte 1 ila 15 saniye. xAI'ın güvenlik filtresi geçerlidir.
xAI'ın video için geliştirdiği Grok Imagine; metinden, referans görsellerden veya düzenlenecek bir kaynak videodan video üretir. xAI'ın güvenlik filtresi geçerlidir.
Girdi olarak image, additional_images ve video kabul eder.
Hızlı başlangıç
Grok Video API'yi çağırma
MAGE_API_KEY'i ayarla, isteği /grok_video/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.
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"])Modeller
Grok Video model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| grok-imagine-video | Grok Video | Evet |
Seçenekler
Grok Video parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| 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 |
Girdiler
Grok Video'nun kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
| video | Kaynak video. |
Kurallar
Grok Video API'nin uyguladığı kurallar
- Kaynak video en fazla 8,7 saniye olmalıdır ve referans görsellerle birlikte kullanılamaz.
- En fazla 5 referans görsel kullanılabilir; bu durumda klip 10 saniyeyle sınırlanır.
Diğer video modelleri
Mage'deki diğer yapay zeka video oluşturma API'leri
Video · 270 Gems'ten başlayan fiyatlarla
Kiwi API
Günlük videolar, sıfır kurulum
Video · 245 Gem'den başlayan fiyatlarla
Lemon API
Tüm video özellikleri, daha uygun fiyata
Video · 20 Gems'ten başlayan fiyatlarla
LTX Video API
Hızlı denemeler için açık ağırlıklı video modeli
Video · 147 Gems'ten başlayan fiyatlarla
Melon API
Hareket halinde anime, isteğe bağlı sesle
Video · 30 Gems'ten başlayan fiyatlarla
MiniMax-H3 API
Stereo sesli hızlı açık video modeli
Video · 338 Gem'den başlayan fiyatlarla
Plum API
Her klipte ses, 2K'ya kadar
SSS
Sık sorulan sorular
Grok Video API ne kadar?
Varsayılan ayarlarda (Grok Video) bir Grok Video isteği 375 Gems tutarında, yani yaklaşık 0,375 $'dır. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta belirtilir. Başarısız olan üretimlerin ücreti iade edilir; Mage'in içerik politikası tarafından engellenenlerin ücreti iade edilmez.
Grok Video API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/grok_video/generate adresine istek gönder. Yanıt, sonucu sorgulamak için bir status_url içerir.
Hangi Grok Video modellerini çağırabilirim?
grok-imagine-video (Grok Video). Varsayılan model Grok Video'dur.
Grok Video referans görselleri veya karakterleri destekliyor mu?
Grok Video image, additional_images, video girdilerini kabul eder. Grok Video, kayıtlı karakterleri ve referansları prompt içinde @handle ile alır.
Grok Video'yu Claude veya ChatGPT üzerinden kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Grok Video'yu adıyla iste. Asistanın seçenekleri get_model ile okur ve üretmeden önce fiyatı söyler.
Grok Video sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.