TL;DR
Grok metinden videoya API'si, bir metin isteminden video oluşturur. `POST /v1/videos/generations` çağrısı yapar, hemen bir `request_id` alır, ardından durum `"done"` olana kadar `GET /v1/videos/{request_id}` adresini sorgularsınız. Model `grok-imagine-video`'dur ve fiyatlandırma 480p çözünürlükte saniye başına 0,05 dolardan başlar. xAI Python SDK'sı sorgulama işlemini otomatik olarak yönetir.
Giriş
xAI, yalnızca Ocak 2026'da 1,2 milyar video üretti. Bu, Grok metinden videoya API'sinin 28 Ocak 2026'da piyasaya sürülmesinden sonraki ilk aydı. Model aynı ay Artificial Analysis metinden videoya liderlik tablosunda da bir numaraya yerleşti. Bu rakamlar önemlidir çünkü altyapının büyük ölçekte kanıtlandığını gösterirler.
Bu rehber, ilk isteğinizi yapmaktan, sonucu sorgulamaya, parametreleri ayarlamaya ve daha iyi istemler yazmaya kadar her adımda size yol gösterecektir. Ayrıca referans görsellerini nasıl kullanacağınızı, mevcut videoları nasıl uzatacağınızı veya düzenleyeceğinizi ve metinden videoya özelliğinin ne zaman doğru seçim olduğunu öğreneceksiniz.
Grok Metinden Videoya API'si Nedir?
Grok metinden videoya API'si, xAI'nin `https://api.x.ai` adresindeki medya oluşturma paketinin bir parçasıdır. Bir metin istemi gönderirsiniz ve `grok-imagine-video` modeli sıfırdan kısa bir video klip oluşturur. Kaynak görsel gerekmez.
API, eş zamanlı bir görsel oluşturma uç noktası (`POST /v1/images/generations`, `grok-imagine-image` modeli, görsel başına 0,02$) ile birlikte çalışır. Ayrıca videoları uzatmak veya düzenlemek için uç noktalar da içerir.
Metinden videoya uç noktası, görselden videoya uç noktasından temel bir şekilde farklıdır: yalnızca kelimeler sağlarsınız. Model, sahneyi, hareketi ve görsel stili tamamen sizin açıklamanızdan oluşturur. Eğer bir kaynak görseliniz varsa ve modelin onu canlandırmasını istiyorsanız Grok görselden videoya API rehberine bakın.
Metinden Videoya Oluşturma Nasıl Çalışır (Eş Zamansız Desen Basitçe Açıklandı)
Çoğu API çağrısı eş zamanlıdır. Bir istek gönderir, bir an beklersiniz, yanıtınızı alırsınız. Video oluşturma saniyelerden dakikalara kadar sürdüğü için, API bunun yerine eş zamansız bir desen kullanır.
İşte akış:
- Bir POST isteğiyle isteminizi gönderirsiniz.
- API hemen (bir saniyeden kısa sürede) bir `request_id` döndürür.
- Video, xAI sunucularında oluşturulmaktadır.
- Bu `request_id` ile bir GET uç noktasını tekrar tekrar sorgularsınız.
- Durum `"processing"`'den `"done"`'a değiştiğinde, yanıt bir video URL'si içerir.
Bu desen, yapay zeka medya API'lerinde yaygındır. HTTP bağlantılarınızı kısa tutar ve ilerlemeyi kendi hızınızda kontrol etmenizi sağlar. İşin püf noktası, ön ucunuzun ara durumu yönetmesi, video URL'si gelene kadar bir yükleme göstergesi göstermesidir.
Ön Koşullar
Herhangi bir kod yazmadan önce iki şeye ihtiyacınız var:
Bir xAI hesabı. console.x.ai adresinde bir hesap oluşturun. API anahtarınız oluşturma erişimine sahip olmadan önce orada faturalandırma bilgilerini de ekleyeceksiniz.
Bir API anahtarı. xAI konsolunda API Anahtarları'na gidin ve yeni bir anahtar oluşturun. Onu güvenli bir yere kopyalayın. Her istek başlığında bir Taşıyıcı (Bearer) token'ı olarak geçireceksiniz.

Kod içinde sabit değer olarak belirtmemek için bir ortam değişkeni olarak ayarlayın:
export XAI_API_KEY="your_api_key_here"
İsteğe bağlı olarak, en basit entegrasyon için xAI Python SDK'sını yükleyin:
pip install xai-sdk
İlk Metinden Videoya İsteğiniz
Uç nokta `POST https://api.x.ai/v1/videos/generations`'dır. Tek gerekli alanlar `model` ve `prompt`'tur.
Curl Kullanımı
curl -X POST https://api.x.ai/v1/videos/generations \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A golden retriever running through autumn leaves in slow motion, cinematic lighting"
}'
Yanıt hemen geri döner:
{
"request_id": "d97415a1-5796-b7ec-379f-4e6819e08fdf"
}
Bu UUID, video hazır olduğunda onu almak için biletinizdir.
Python'ı requests Kütüphanesiyle Kullanma
import requests
import os
API_KEY = os.environ["XAI_API_KEY"]
BASE_URL = "https://api.x.ai"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-video",
"prompt": "A golden retriever running through autumn leaves in slow motion, cinematic lighting"
}
response = requests.post(
f"{BASE_URL}/v1/videos/generations",
headers=headers,
json=payload
)
data = response.json()
request_id = data["request_id"]
print(f"Generation started. Request ID: {request_id}")
Video Sonucu için Sorgulama
Bir `request_id`'ye sahip olduktan sonra, durum alanı `"done"` olana kadar `GET /v1/videos/{request_id}` adresini sorgulayın.
Durum alanının üç olası değeri vardır: - "processing": hala oluşturuluyor - "done": tamamlandı, video URL'si mevcut - "failed": bir şeyler ters gitti
İşte eksiksiz bir Python sorgulama döngüsü:
import requests
import time
import os
API_KEY = os.environ["XAI_API_KEY"]
BASE_URL = "https://api.x.ai"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
def poll_video(request_id: str, interval: int = 5, max_attempts: int = 60) -> dict:
"""Poll until video generation is complete."""
url = f"{BASE_URL}/v1/videos/{request_id}"
for attempt in range(max_attempts):
response = requests.get(url, headers=headers)
data = response.json()
status = data.get("status")
progress = data.get("progress", 0)
print(f"Attempt {attempt + 1}: status={status}, progress={progress}%")
if status == "done":
return data
elif status == "failed":
raise RuntimeError(f"Video generation failed: {data}")
time.sleep(interval)
raise TimeoutError(f"Video not ready after {max_attempts} attempts")
# Full workflow: generate then poll
def generate_video(prompt: str) -> str:
"""Generate a video and return its URL."""
response = requests.post(
f"{BASE_URL}/v1/videos/generations",
headers={**headers, "Content-Type": "application/json"},
json={"model": "grok-imagine-video", "prompt": prompt}
)
request_id = response.json()["request_id"]
print(f"Request ID: {request_id}")
result = poll_video(request_id)
video_url = result["video"]["url"]
print(f"Video ready: {video_url}")
return video_url
video_url = generate_video(
"A timelapse of a city skyline at sunset transitioning to night, aerial view"
)
Tamamlandığında, tam sorgulama yanıtı şöyle görünür:
{
"status": "done",
"video": {
"url": "https://vidgen.x.ai/....mp4",
"duration": 8,
"respect_moderation": true
},
"progress": 100,
"usage": {
"cost_in_usd_ticks": 500000000
}
}
xAI Python SDK'sını Kullanma
Manuel sorgulamayı atlamak isterseniz, xAI SDK bunu sizin için halleder. `client.video.generate()` yöntemi, video hazır olana kadar engelleme yapar.
from xai_sdk import Client
import os
client = Client(api_key=os.environ["XAI_API_KEY"])
result = client.video.generate(
model="grok-imagine-video",
prompt="A golden retriever running through autumn leaves in slow motion",
duration=8,
resolution="720p",
aspect_ratio="16:9"
)
print(f"Video URL: {result.video.url}")
print(f"Duration: {result.video.duration}s")
SDK, çalışan koda en hızlı yoldur. Yeniden deneme mantığı, ilerleme güncellemeleri veya özel sorgulama aralıkları üzerinde daha fazla kontrole ihtiyacınız olduğunda ham istekler yaklaşımını kullanın.
Video Oluşturma için Etkili İstemler Yazmak
İsteminiz en önemli girdidir. Ayrıntılı, yapılandırılmış bir istem, belirsiz bir istemden çok daha iyi sonuçlar verir.
Sahne açıklaması
Konuyu ve ortamı birlikte açıklayın. Neyin görünür olduğu konusunda belirli olun. "Yağmur izli bir pencerenin yanında ahşap bir masanın üzerindeki beyaz seramik kahve kupası", "bir kahve kupası" ifadesinden daha gerçekçi bir sahne oluşturur.
Hareket
Modele neyin, nasıl hareket ettiğini söyleyin. "Buhar yukarı doğru kıvrılırken kamera kupanın etrafında yavaşça döner" ifadesi, net bir yöne sahip hareket ekler. Açık hareket ipuçları olmadan, model minimal veya sarsıntılı hareketler oluşturabilir.
Kamera Stili
Bir görüntü yönetmenine vereceğiniz kamera terminolojisini kullanın: "yakın çekim," "takip çekimi," "havadan drone görünümü," "el çekimi," "dolly zoom." Bu ipuçları, oluşturulan çekimlere güvenilir bir şekilde çevrilir.
Aydınlatma ve Ruh Hali
"Altın saat," "kapalı hava," "neon ışıklı" ve "stüdyo üç noktalı aydınlatma" hepsi farklı görünümler üretir. Aydınlatmayı ruh haliyle eşleştirin: "sisli sabah, melankolik atmosfer" modele renk sıcaklığının ötesinde ton rehberliği sağlar.
Stil Referansları
Aklınızda görsel bir stil varsa adını belirtin: "sinematik," "belgesel," "anime," "stop-motion," "hyperlapse." İki stili birleştirmek genellikle ilginç sonuçlar verir.
İşleyen İstem Yapısı
Konuyla başlayın, hareket ekleyin, kamerayı tanımlayın, stil ve ruh haliyle bitirin. Şunun gibi:
A lone astronaut floats past the International Space Station,
tether drifting behind them. The camera tracks slowly
alongside, showing Earth below. Cinematic, IMAX quality,
warm sunrise light reflecting off the visor.
Çözünürlük, Süre ve En Boy Oranını Kontrol Etme
Oluşturma uç noktası, çıktı boyutlarını, uzunluğunu ve kalitesini kontrol etmenizi sağlayan birkaç isteğe bağlı parametre kabul eder.
Süre
"duration": 10
Aralık: 1 ila 15 saniye. Varsayılan 6 saniyedir. Daha uzun videolar daha pahalıdır. 480p'de 10 saniyelik bir klip 0,50 dolara mal olur.
Çözünürlük
"resolution": "720p"
İki seçenek: `"480p"` (varsayılan) ve `"720p"`. Prototipleme ve test için 480p kullanın. Kalitenin önemli olduğu üretim çıktıları için 720p kullanın.
En Boy Oranı
"aspect_ratio": "9:16"
Mevcut oranlar:
| Oran | En uygun |
|---|---|
16:9 |
Masaüstü, YouTube, sunumlar (varsayılan) |
9:16 |
TikTok, Instagram Reels, mobil |
1:1 |
Instagram akışı, sosyal kartlar |
4:3 |
Klasik video, sunumlar |
3:4 |
Dikey mobil içerik |
3:2 |
Standart fotoğraf oranı |
2:3 |
Dikey fotoğrafçılık |
Tüm Parametrelerle Tam Bir Örnek
curl -X POST https://api.x.ai/v1/videos/generations \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A coastal town at dawn, waves breaking gently on a rocky shore",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
Video Stiline Rehberlik Etmek için Referans Görseller Kullanma
`reference_images` parametresi, en fazla 7 görsel URL'sinden oluşan bir dizi kabul eder. Bu görseller, oluşturulan videonun konusu haline gelmeden görsel stilini ve içeriğini yönlendirir.
{
"model": "grok-imagine-video",
"prompt": "A coastal town at dawn, waves breaking gently on a rocky shore",
"reference_images": [
{"url": "https://example.com/my-style-reference.jpg"},
{"url": "https://example.com/color-palette-reference.jpg"}
]
}
Referans görseller, tutarlı bir estetiği paylaştıklarında en iyi sonucu verir. Farklı görsel stillerden üç görsel sağlarsanız, model bunları uzlaştırmaya çalışır ve çıktı tutarsız görünebilir. En güçlü rehberlik için birleşik bir görünüme sahip sıkı bir görsel seti kullanın.
Referans görseller, görselden videoya uç noktasından farklıdır. Referans görsellerle, sahneyi hala isteminiz yönlendirir. Görseller renk derecelendirmesini, kompozisyon stilini ve görsel dokuyu etkiler. Görselden videoya ile kaynak görsel ilk kare haline gelir.
Oluşturulan Videoları Uzatma ve Düzenleme
xAI, daha önce oluşturduğunuz videolarla çalışmak için iki ek uç nokta sunar.
Bir Videoyu Uzatma
`POST /v1/videos/extensions`, mevcut bir oluşturulmuş videoya daha fazla çekim ekler. Orijinal videonun `request_id`'sini ve uzatma için yeni bir istemi iletirsiniz. Bu, tek bir çağrıda 15 saniyelik sınıra ulaşmadan daha uzun diziler oluşturmak için kullanışlıdır.
Bir Videoyu Düzenleme
`POST /v1/videos/edits`, bir metin talimatına göre mevcut bir videoyu değiştirir. Daha önce oluşturduğunuz bir klibin stilini değiştirebilir, sahneyi düzenleyebilir veya efektler uygulayabilirsiniz.
Her iki uç nokta da ana oluşturma uç noktasıyla aynı eş zamansız deseni takip eder. Bir `request_id` döndürürler ve sonuç için `GET /v1/videos/{request_id}` adresini sorgularsınız.
API Yanıtından Maliyeti Okuma
Tamamlanan sorgulama yanıtı bir `usage` nesnesi içerir:
"usage": {
"cost_in_usd_ticks": 500000000
}
Birim USD tick'tir. Dolara dönüştürmek için 10.000.000'a bölün.
cost_in_usd = result["usage"]["cost_in_usd_ticks"] / 10_000_000
print(f"Cost: ${cost_in_usd:.4f}")
# Output: Cost: $0.0500
Fiyatlandırma Referansı
| Çözünürlük | Saniye başına fiyat | 10 saniyelik klip |
|---|---|---|
| 480p | $0.05 | $0.50 |
| 720p | $0.07 | $0.70 |
`500000000` tick değeri 0,50 dolara eşittir. Bu, 480p'de 10 saniyelik bir klibe denk gelir.
Tamamlanan her yanıttan `cost_in_usd_ticks` değerini kaydederek maliyetlerinizi takip edin. Bu, xAI faturalandırma API'sini ayrı olarak çağırmadan kullanım panoları oluşturmanızı sağlar.
Grok Video API'nizi Apidog ile Nasıl Test Edersiniz?
Eş zamansız sorgulama deseni, belirli bir test zorluğu yaratır. Ön uç kodunuzun üç durumu ele alması gerekir: yükleme (sorgulama sırasında), başarı (video URL'si alındı) ve hata. Her çağrı zaman aldığı ve paraya mal olduğu için bu üç durumu gerçek API çağrıları yaparak test edemezsiniz. Apidog'un Akıllı Sahte (Smart Mock) özelliği sorunu doğrudan burada çözer.

Kullanım Durumu 1: Ön Uç Geliştirme için Akıllı Sahte (Smart Mock)
Apidog'un Akıllı Sahte özelliğiyle, her iki uç nokta için şemayı tanımlarsınız ve Apidog anında gerçekçi sahte yanıtlar döndürür.
Oluşturma uç noktasını taklit edin:
Apidog'da, projenizde `POST /v1/videos/generations` uç noktasını oluşturun. Yanıt şemasını tek bir `request_id` dize alanı ile tanımlayın. Akıllı Sahte, alan adı desenine göre otomatik olarak sahte bir UUID döndürecektir.
Sahte yanıtınız:
{
"request_id": "d97415a1-5796-b7ec-379f-4e6819e08fdf"
}
Sorgulama uç noktasını taklit edin:
Apidog'da `GET /v1/videos/{request_id}` adresini oluşturun. `status`, `video.url`, `video.duration`, `progress` ve `usage.cost_in_usd_ticks` dahil olmak üzere tam yanıt şemasını tanımlayın. Yer tutucu bir MP4 URL'si ile `"status": "done"` döndüren özel bir Sahte yanıt ayarlayın.
Sahte sorgulama yanıtınız:
{
"status": "done",
"video": {
"url": "https://vidgen.x.ai/mock-video-12345.mp4",
"duration": 8,
"respect_moderation": true
},
"progress": 100,
"usage": {
"cost_in_usd_ticks": 400000000
}
}
Ön uç geliştiricileri artık bu sahte sunucuya karşı tüm video oynatıcı kullanıcı arayüzünü oluşturabilir ve test edebilir. Yükleme durumunu, tamamlanma durumunu görürler ve sahte yanıtı `"status": "failed"` döndürecek şekilde değiştirerek hata durumunu tetikleyebilirler. Geliştirme sırasında gerçek API kredileri harcanmaz.
Kullanım Durumu 2: Sorgulama Döngüsü için Test Senaryoları
Entegrasyonunuz oluşturulduktan sonra, tam oluşturma-sorgulama akışını otomatik olarak doğrulamak için Apidog'un Test Senaryolarını kullanın.
Adım 1: Oluşturma isteğini ekleyin. Test senaryonuzdaki ilk adım olarak `POST /v1/videos/generations` adresini ekleyin. Son işlemcide, JSONPath ifadesi `$.request_id` kullanarak yanıt gövdesinden `request_id`'yi yakalamak için bir Değişken Çıkar (Extract Variable) ekleyin. Bunu `videoRequestId` adlı bir değişkende saklayın.
Adım 2: Bir sorgulama döngüsü ekleyin. İkinci adım olarak `GET /v1/videos/{{videoRequestId}}` adresini ekleyin. Bunu, `response.body.status == "done"` koşuluyla bir For döngüsüne sarın. Hız sınırını aşmamak için tekrarlar arasında 5 saniyelik bir Bekleme işlemcisi ekleyin.
Adım 3: Sonucu doğrulayın. Döngüden çıktıktan sonra, son GET isteğine bir Doğrulama işlemcisi ekleyin. `$.video.url`'nin boş olmadığını doğrulayın. Bu, tam döngünün başarıyla tamamlandığını onaylar.
Bu test senaryosu, eş zamansız akışın tekrarlanabilir, otomatik kapsamını sağlar. Sorgulama mantığınız değiştiğinde herhangi bir gerilemeyi yakalamak için onu CI'da çalıştırın.
Metinden Videoya mı, Görselden Videoya mı: Hangisini Ne Zaman Kullanmalı
Her iki mod da aynı `grok-imagine-video` modelini kullanır, ancak farklı amaçlara hizmet ederler.
Metinden videoya özelliğini şu durumlarda seçin:- Bir konsept veya senaryodan orijinal içerik oluşturuyorsanız - Modelin kompozisyon üzerinde tam yaratıcı kontrol sahibi olmasını istiyorsanız - Kullanıcıların istemler yazdığı bir içerik oluşturma aracı geliştiriyorsanız - Başlamak için bir kaynak görseliniz yoksa
Görselden videoya özelliğini şu durumlarda seçin:- Canlandırılacak bir ürün fotoğrafınız, illüstrasyonunuz veya marka varlığınız varsa - Mevcut bir görselden belirli görsel ayrıntıları korumanız gerekiyorsa - Bir dizi ilişkili görselden tutarlı animasyonlar oluşturuyorsanız - Kendi sanat eserinizi veya fotoğrafınızı canlandırmak istiyorsanız
Temel ayrım: metinden videoya sıfırdan bir sahne oluşturur. Görselden videoya, mevcut bir görseli hareket ettirir. Görselden videoya yaklaşımının tam bir açıklaması için Grok görselden videoya API rehberine bakın.
Her iki modu da sunan ürünler geliştiren ekipler için, çalışma zamanında girdi türünü algılayabilirsiniz. Kullanıcı bir görsel yüklüyorsa, `POST /v1/images/generations` (görselden videoya) adresine yönlendirin. Yalnızca bir istem yazıyorlarsa, `POST /v1/videos/generations` adresine yönlendirin.
Sık Karşılaşılan Hatalar ve Bunları Nasıl Düzeltebileceğiniz
401 YetkisizAPI anahtarınız eksik, süresi dolmuş veya yanlış biçimlendirilmiş. Yetkilendirme başlığının boşluksuz olarak tam olarak `Bearer YOUR_XAI_API_KEY` olduğundan emin olun. Anahtarın xAI konsolunda aktif olduğunu onaylayın.
429 Çok Fazla İstekHız sınırına ulaştınız. API dakikada 60 isteğe ve saniyede 1 isteğe izin verir. İstekler arasına bir gecikme ekleyin. Sorgulama yapıyorsanız, çağrılarınız arasında en az 5 saniye boşluk bırakın.
sorgulama yanıtında durum: "başarısız"Oluşturma başarısız oldu. Bu genellikle istemin içerik denetimi tarafından reddedildiği anlamına gelir. Yanıttaki `respect_moderation` alanı, denetimin uygulandığını belirtmek için `true` olacaktır. İsteminizi daha az belirsiz olacak şekilde revize edin veya potansiyel olarak hassas dili çıkarın.
Video URL'si 404 döndürüyorOluşturulan video URL'leri belirli bir süre sonra sona erer. URL'yi aldıktan hemen sonra videoyu kendi depolama alanınıza indirin. URL'yi kaydetmeyin ve günlerce sonra erişilebilir olmasına güvenmeyin.
Boş veya donmuş videoBelirsiz istemler veya hareket ipuçları içermeyen istemler bazen minimal hareketli videolar üretir. İsteminize açık hareket dili ekleyin: neyin, hangi yöne ve hangi hızda hareket ettiğini açıklayın.
Yavaş sorgulama süreleri720p videoların oluşturulması 480p videolardan daha uzun sürer. Daha uzun süreler de daha fazla zaman alır. Geliştirme ve prototipleme için, yineleme döngüsünü hızlandırmak amacıyla `"resolution": "480p"` ve kısa süreler kullanın.
Sonuç
Grok metinden videoya API'si, metinden videoya giden doğrudan bir yol sunar. Bir istem gönderir, bir `request_id` alır, tamamlanana kadar sorgular ve MP4 dosyanızı alırsınız. Eş zamansız desen anlaşılması gereken temel kavramdır. Sorgulama döngüsü çalıştığında, diğer parametrelerin (süre, çözünürlük, en boy oranı, referans görseller) ayarlanması basittir.
Üretim derlemeleri için, tamamlanan her yanıttan `cost_in_usd_ticks` değerini okuyarak maliyet takibi ekleyin. Geliştirme sırasında Apidog'da her iki uç noktayı da taklit edin, böylece ön uç ekibiniz gerçek oluşturmaları beklerken engellenmez. Entegrasyonunuz geliştikçe sorgulama mantığınızı güvenilir tutmak için Test Senaryolarını kullanın.
Grok video API'si için sahte sunucunuzu ve test senaryolarınızı kurmak için Apidog'u ücretsiz indirin.
Sıkça Sorulan Sorular (SSS)
Metinden videoya oluşturma için hangi model adını kullanmalıyım?`grok-imagine-video` kullanın. Bu, `/v1/videos/generations` adresine yaptığınız POST isteğindeki gerekli `model` alanıdır.
Video oluşturma ne kadar sürer?Süreye ve çözünürlüğe göre değişir. Kısa 480p klipler 30 saniyeden kısa sürede tamamlanabilir. Daha uzun 720p klipler birkaç dakika sürebilir. Uç noktayı sürekli zorlamak yerine her 5-10 saniyede bir sorgulama yapın.
15 saniyeden uzun bir video oluşturabilir miyim?Tek bir istekte değil. Maksimum `duration` 15 saniyedir. Daha uzun videolar oluşturmak için bir klip oluşturun ve ardından daha fazla çekim eklemek için `POST /v1/videos/extensions` adresini kullanın.
Oluşturulan videoyu nasıl indiririm?Tamamlanan sorgulama yanıtındaki `result.video.url` adresindeki URL'yi kullanın. MP4 dosyasını hemen kendi depolama alanınıza indirin. URL geçicidir ve süresi dolacaktır.
İstemim içerik denetimini ihlal ederse ne olur?İş tamamlanacak ancak `status` `"failed"` olacaktır. Sorgulama yanıtındaki `respect_moderation` alanı, denetimin uygulandığını gösterir. İsteminizi revize edin ve tekrar deneyin.
Video API'si için ücretsiz bir katman var mı?xAI, oluşturulan çıktının saniyesi başına ücret alır. Video oluşturma için özel bir ücretsiz katman yoktur. Yeni hesaplar için güncel kredi tekliflerini console.x.ai adresinden kontrol edin.
`reference_images` bir kaynak görselle başlamaktan nasıl farklıdır?Referans görseller, metinden videoya oluşturmanın görsel stilini yönlendirir. Konu haline gelmeden görünümü etkilerler. Görselden videoya için bir kaynak görsel, videonun gerçek ilk karesi haline gelir.
Kredi harcamadan sorgulama döngüsünü test etmenin en iyi yolu nedir?Hem oluşturma hem de sorgulama uç noktalarını taklit etmek için Apidog'un Akıllı Sahte (Smart Mock) özelliğini kullanın. Şemaları tanımlayın, `"processing"` ve `"done"` durumları için sahte yanıtları ayarlayın ve sorgulama kodunuz gerçek API'ye dokunmadan çalışacaktır.
