CometAPI ile geliştirinBirden çok model için tek bir API mi gerekiyor?İş akışını Playground'da test edin, ardından model ve maliyet kullanım senaryonuza uyduğunda bir API anahtarı oluşturun.
Grok Voice 3.0, xAI’nin gerçek zamanlı konuşmadan konuşmaya modelidir ve 14 Ekim 2026’da yayımlandı. API model adı grok-voice-3.0’dır; 3 Kasım 2026 itibarıyla, grok-voice-latest bu sürüme işaret ediyor. Lansman duyurusu, ses oturumlarını dakikada $0.08 (saatte $4.80) olarak listeler. Sesli asistanlar ve müşteri destekleri için sohbet, araya girme yönetimi ve araç kullanımını bir araya getirir. Temel Python, bir xAI API anahtarı ve websockets kitaplığı ile bir istem gönderebilir ve konuşulan bir yanıtı kaydedebilirsiniz. Aşağıdaki örnekle başlayın; ardından kaydedilmiş ses, canlı mikrofon akışı ve uygulamanız büyüdükçe iş araçları ekleyin.
Netlik, kaynak ataması ve güncel API terminolojisi açısından gözden geçirildi.
Key Takeaways
Grok Voice 3.0, konuşma ve metni gerçek zamanlı olarak değiş tokuş eder. Uygulamanız, sohbet boyunca WebSocket üzerinden oturum olayları gönderir ve alır.
İlk testiniz tek bir metinden sese tur olabilir. Oynatılabilir bir yanıt, kimlik doğrulamanın ve ses üretiminin mikrofon eklemeden önce çalıştığını doğrular.
Ses girişi, eşleşen bir biçim ve net bir konuşma turu sınırı gerektirir. Uygulamanız, manuel tur tamamlamasıyla kaydedilmiş PCM ses gönderebilir ya da sunucu taraflı ses tespitiyle mikrofon sesini akış halinde iletebilir.
Uygulamanız iş eylemlerini kontrol eder. İşlev argümanlarını ve kullanıcı izinlerini doğrular, onaylanan eylemi yürütür ve sesli ajan sürdürebilsin diye sonucu geri döndürür.
Tarayıcı ve mobil istemciler kısa ömürlü kimlik bilgileri kullanır. Sunucunuz kalıcı API anahtarını tutar ve istemci bağlantıları için geçici belirteçler verir.
What Is Grok Voice 3.0?
Grok Voice 3.0, xAI tarafından SpaceX Super Intelligence markası altında geliştirilen gerçek zamanlı, konuşma odaklı bir modeldir. Konuşma ya da metin girdisi kabul eder ve devam eden bir oturum içinde ses ve metin döndürebilir. Model, genel metin odaklı Grok modellerinin doğrudan ikamesi olarak hizmet etmekten ziyade, sesli ajan kullanım senaryolarına göre optimize edilmiştir.
Geleneksel sesli asistanlar genellikle konuşma tanıma, bir dil modeli ve konuşma sentezini zincirler. Grok Voice bunun yerine, entegre sohbet davranışı ve araç desteği olan bir konuşmadan konuşmaya oturum sunar. Bu mimari, geliştiricinin orkestrasyon katmanını basitleştirebilir; ancak uygulamaların yine de ses yakalama, taşıma, yetkilendirme, iş entegrasyonları ve izleme gereksinimleri vardır.
Grok Voice 3.0 model tanımı, giriş ve çıkış modaliteleri olarak metin ve sesi belirler. Bu eğitim için ilk faydalı kontrol noktası, sunucu taraflı bir Python betiğinden oynatılabilir bir yanıttır.
Key Features and Capabilities of Grok Voice 3.0
Canlı bir konuşma sürdür: bir oturum boyunca WebSocket üzerinden konuşma ve metin alışverişi yap.
Araya girmeleri yönet: sunucu taraflı ses tespiti kullan ve arayan konuşmaya başladığında kuyruğa alınmış çalmayı durdur.
İş araçlarını kullan: sipariş sorgulama ve planlama gibi görevler için kendi işlevlerine bağlan.
Grok Voice 3.0 Benchmark Performance
Resmi lansman raporu, 13 Ekim 2026 tarihli şu Artificial Analysis sonuçlarını aktarır:
Bunlar yayımlanmış kıyaslama sonuçlarıdır; dağıtımınız için garanti değildir. Müşterilerle kullanmadan önce kendi aksanlarınızı, gürültü koşullarınızı, araçlarınızı ve eskalasyon yollarınızı test edin.
What Do You Need Before Calling the Grok Voice 3.0 API?
xAI Console üzerinde bir hesap oluşturun veya oturum açın, bir API anahtarı üretin ve hesabınızın erişimi ve kullanılabilir kullanım kredisi olduğunu kontrol edin. Python örneği için yerel bir terminal veya güvenilir bir sunucu kullanın.
Aynı ortamda Python 3.11 veya sonrası ve pip.
XAI_API_KEY olarak saklanmış geçerli bir xAI API anahtarı.
Dışa giden güvenli WebSocket bağlantılarına izin veren bir ağ bağlantısı.
Oluşturulan WAV dosyasını açmak için bir medya oynatıcı.
xAI Console’da bir anahtar oluşturun. Uygulamada sabitlemek yerine bir ortam değişkeninde saklayın.
API anahtarını mevcut Bash terminali için ayarlayın.
export XAI_API_KEY="your_xai_api_key"
Windows PowerShell üzerinde:
API anahtarını mevcut PowerShell oturumu için ayarlayın.
$env:XAI_API_KEY="your_xai_api_key"
Python ortamınıza WebSocket istemcisini kurun.
python -m pip install "websockets>=14,<18"
Kalan komutları aynı terminal oturumunda çalıştırın. Sanal bir ortam kullanıyorsanız paketi yüklemeden önce etkinleştirin.
How to Use the Grok Voice 3.0 API with Python
Yerel Realtime API, bir WebSocket bağlantısı kullanır. Sıradan metin sohbet tamamlamalarının aksine, devam eden bir sohbet sırasında süregelen oturum olaylarını değiş tokuş eder ve ses parçacıklarını akan şekilde iletir.
Step 1: Select a fixed model and configure the session
API, WebSocket URL’sinde sürümlü bir model adını kabul eder. Örnek, talep edilen sürümü açıkça belirtmek için grok-voice-3.0 kullanır. Bir session.update olayı sesi, ses biçimini ve manuel tur işlemeyi ayarlar; istemi göndermeden önce session.updated’i bekleyin.
Step 2: Send text and collect the spoken response
Aşağıdaki betiği grok_voice_demo.py olarak kaydedin. Tek bir metin istemi gönderir, base64 kodlu ses parçalarını toplar ve mono, 24 kHz, 16 bit PCM WAV dosyası yazar. Ayrıca API hatalarında, başarısız tamamlamada veya ses üretmeyen bir yanıtta durur.
Metin isteminden tek bir konuşulan yanıt oluşturun ve bir WAV dosyası olarak kaydedin.
Başarılı bir yanıttan sonra, terminal Saved grok_response.wav çıktısını yazdırır. Bu dosyayı bir medya oynatıcıda açın ve normal hızda tam bir yanıt duyduğunuzu kontrol edin. Eksik veya oynatılamayan bir dosya, daha fazla özellik eklemeden önce dönen olayları ve ses yapılandırmasını incelemek için bir nedendir.
Gerçek zamanlı olay başvurusu, burada kullanılan oturum onayı ve yanıt yaşam döngüsünü açıklar. Betik, dosyayı yazmadan önce tüm turu bekler; etkileşimli bir sesli uygulama, ses parçacıklarını geldikçe çalmalıdır.
How Do You Send Audio to Grok Voice 3.0?
Recorded audio with manual turn completion
Bu örnek mono, 24 kHz, 16 bit PCM WAV dosyası kullanır. Grok Voice 3.0 diğer PCM örnekleme hızlarını, μ-law, A-law ve Opus’u da destekler. Gerçek biçim, session.update yapılandırmasıyla eşleşmelidir. Önceki betikte yalnızca conversation.item.create bloğunu aşağıdaki parçayla değiştirin. Aşağıdaki response.create çağrısını ve mevcut alma döngüsünü koruyun.
Metin mesajı bloğunu, main() içinde kaydedilmiş ses yüklemesiyle değiştirin.
with wave.open("request.wav", "rb") as source:
if (
source.getnchannels() != 1
or source.getsampwidth() != 2
or source.getframerate() != SAMPLE_RATE
or source.getcomptype() != "NONE"
):
raise ValueError("Use mono, 24 kHz, 16-bit PCM WAV audio.")
pcm = source.readframes(source.getnframes())
if len(pcm) < SAMPLE_RATE * 2 // 10:
raise ValueError("Use a spoken recording longer than 100 ms.")
for offset in range(0, len(pcm), 4800):
await ws.send(json.dumps({
"type": "input_audio_buffer.append",
"audio": base64.b64encode(pcm[offset:offset + 4800]).decode("ascii"),
}))
await ws.send(json.dumps({"type": "input_audio_buffer.commit"}))
while (await receive_event(ws)).get("type") != "input_audio_buffer.committed":
pass
Bu değişimi, WebSocket bağlamı içinde, özgün metin mesajı bloğuyla aynı girinti düzeyinde yapın. WAV kapsayıcı başlığı değil, WAV dosyasındaki ham PCM örneklerini gönderir. İlk betik açıkça manuel tur işlemeyi seçtiği için, arabelleği commit etmek ve ardından yanıt istemek ayrı eylemlerdir.
Live microphone capture and immediate playback
Etkileşimli bir sohbet için, sesi sürekli yakalayın, yapılandırılan giriş biçimine dönüştürün ve kısa parçalar halinde gönderin; bu sırada ayrı bir alma döngüsü yanıtları işler. Kaydedilmiş dosya örneğinde kullanılan manuel mod yerine otomatik tur tespiti için server_vad seçin. Sunucu yanıtı zaten oluştururken ikinci bir response.create eklemekten kaçının.
Araya girildiğinde, kuyruktaki asistan sesini derhal durdurun. Ağ iptali tek başına, uygulamanız tarafından önceden arabelleğe alınmış sesi kaldırmaz. Oynatma kuyruğunu küçük tutun ve dinleyicinin gerçekte ne kadar ses duyduğunu izleyin ki uygulamanız sohbet durumunu tutarlı tutabilsin.
How to Add Tools to a Grok Voice 3.0 Agent?
Uygulamalar, sipariş sorgulama, planlama veya hesap doğrulama gibi araçları sunabilir. Ajan, karmaşık bir sözlü isteği yorumlayabilir, yetkilendirilmiş bir işlevi çağırabilir ve devam etmek için sonucu kullanabilir. Bu, bir müşteri tek bir aramada birkaç ilişkili değişiklik talep ettiğinde özellikle faydalıdır.
API, özel işlevleri ve sunucu tarafından yönetilen araçları destekler. Özel bir işlev için eylemi uygulamanız gerçekleştirir; bir aracı tanımlamak, modeli tek başına veritabanınıza bağlamaz.
session.tools içinde işlev adını, açıklamasını ve JSON argüman şemasını bildirin.
response.function_call_arguments.done’ı ele alın, argümanları ayrıştırın ve işlevi yürütmeden önce arayanın iznini doğrulayın.
Sonucu, item.type’ın function_call_output olarak ayarlandığı ve eşleşen call_id’nin kullanıldığı conversation.item.create olayı olarak döndürün.
Gerekli işlev sonuçları gönderildikten sonra response.create gönderin. Birkaç çağrı birlikte gelirse, modelin devam etmesini istemeden önce bunların tümünün sonuçlarını döndürün.
Teslimat durumunu kontrol etmek gibi salt-okunur bir araçla başlayın. Rezervasyonları değiştiren, iade yapan veya sipariş veren eylemler için, uygulamada kimlik kontrollerini, onayı ve yinelenen istek korumasını zorunlu kılın.
How to Use Grok Voice 3.0 in Browser and Mobile Apps
İstemci tarafı bağlantılar için geçici kimlik bilgileri kullanın. Sunucunuz kalıcı API anahtarıyla kısa ömürlü bir belirteç ister ve bu belirteci istemciye iletir. Kendi belirteç uç noktanıza yapılan istekleri kimlik doğrulayın ve sınırsız bir geçide dönüşmemesi için kullanım sınırları uygulayın.
Mikrofon iznini, kayıt kontrollerini ve bağlantı durumunu arayüzde görünür tutun. Bağlantı kaybını açıkça ele alın: eski çalmayı durdurun, kullanıcıya bağlantının toparlandığını söyleyin ve çoktan tamamlanmış olabilecek eylemleri yeniden yürütmekten kaçının.
How to Troubleshoot Common Grok Voice 3.0 API Errors
Kimlik doğrulama hatası: komutu çalıştıran terminalde XAI_API_KEY’in ayarlı olduğunu ve anahtarın erişimi olan bir hesaba ait olduğunu doğrulayın. Anahtarı günlüklere veya destek mesajlarına yapıştırmayın.
Beklenmeyen istemci kitaplığı argümanları: pip’in, Python betiğini çalıştırmak için kullanılan ortama istenen websockets sürümünü kurduğunu doğrulayın.
Ses çıkışı yok: hata olaylarını ve response.done’ı inceleyin, session.updated’ın yapılandırmayı onayladığını doğrulayın ve manuel tur için bir yanıt istendiğini kontrol edin.
Bozuk çalma: gerçek baytları yapılandırılan kodek, örnekleme hızı, kanal sayısı ve WAV başlığıyla karşılaştırın. Bir MP3 dosyasını WAV olarak yeniden adlandırmak onu dönüştürmez.
Zaman aşımı: ağ erişimini ve hizmet durumunu kontrol edin, ardından son başarılı olayı inceleyin. Başarısız bir bağlantıyı, halihazırda çalışmış olabilecek herhangi bir iş eyleminden ayrı olarak yeniden deneyin.
What Should You Budget for Grok Voice 3.0 API Calls?
Ses kullanımı ve özel entegrasyonlar ayrı ücretler doğurabilir. Bu eğitim için ilgili yayımlanmış oranlar gerçek zamanlı oturum ve metin girdileridir; bağımsız transkripsiyon ve konuşma üretimi ürünleri ayrı hizmetlerdir.
Konuşmadan konuşmaya oturum: dakikada $0.08, yani saatte $4.80.
Bir sesli oturum sırasında metin girişi: giriş başına $0.004.
Örneğin, 500 faturalandırılabilir oturum dakikası, temel ses ücretlerinde $40’a karşılık gelir. Bu tahmin, metin girdilerini, isteğe bağlı araçları, telefon hizmetlerini ve kendi altyapınızı kapsamaz. Kısa test oturumlarıyla başlayın ve sohbet bittiğinde boştaki bağlantıları kapatın.
Conclusion
Grok Voice 3.0 API ile tek bir tam turla başlayın: bağlanın, oturumu yapılandırın, bir istem gönderin, ses alın ve sonucu çalın. Bu yol çalıştığında, kaydedilmiş konuşmayı ekleyin; ardından etrafına mikrofon yakalama ve akış halinde çalmayı inşa edin. İş araçlarını, sohbet ve hata yönetimi yolları güvenilir hale geldikten sonra ekleyin.