İçeriğe geç

Grok Voice

Entegre et

Model kimliği xai/grok-voice
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-voice?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Çalıştırma başına $1,494 değerine kadar gerçek kullanıma göre ücretlendirilir, kalanı iade edilir Bu sayfada çalıştır

API anahtarı al
xAI Ses #xai#grok#voice#agent

Kaydedilmiş bir ses klibini dinleyen ve konuşma ile birlikte transkript döndüren ses aracısı

xAI · Ses

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

0 / 20000

Konuşma bağlamı sağlayan ve Grok'un varsayılanı yerine bir persona belirleyen isteğe bağlı sistem talimatları; belirtilmezse varsayılan persona korunur.

•gerekli audio_url
Dosyayı bırakın veya

Kullanıcının konuşmasını içeren ses URL'si; 10 dakika ve 50 MB ile sınırlıdır. En yaygın ses biçimleri sağlanabilir; Grok sesi almadan önce ses, 24 kHz'de 16 bit örnekli mono PCM'e dönüştürülür. Ajan kayda sesli yanıt verir.

Gelişmiş voice · enable_safety_checker · tools

Ajanın yanıtında Grok'un varsayılanını geçersiz kılmak için yerleşik bir xAI sesi seçin; ayarlanmazsa varsayılan ses korunur.

varsayılan {"mcp_servers":[],"we...

Sunucu tarafında kullanım için ajan araç yapılandırması; ZDR nedeniyle file_search/collections yazımlı yapılandırmadan çıkarılır. Tüm araçlar başlangıçta devre dışıdır; desteklenen seçenekler arasında uzak MCP araçları, web araçları ve X araçları bulunur.

POST /run/xai/grok-voice?wait=20 fiyat → $1,494
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-voice?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Grok Voice hakkında

Bir kaydı `audio_url` üzerinden gönderin; aracı, konuşma sesi olarak yanıt verir ve mevcutsa süresiyle birlikte 24 kHz mono WAV ve transkript döndürür. İsteğe bağlı `prompt` (en fazla 20000 karakter) kişiliği ve bağlamı belirler; `voice` yerleşik bir ses seçer. `tools` nesnesi web aramasını, X aramasını veya uzak MCP sunucularını etkinleştirebilir; bunların tümü varsayılan olarak kapalıdır.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
audio_urlgerekli audio
Türurl · audio
Kullanıcının konuşmasını içeren ses URL'si; 10 dakika ve 50 MB ile sınırlıdır. En yaygın ses biçimleri sağlanabilir; Grok sesi almadan önce ses, 24 kHz'de 16 bit örnekli mono PCM'e dönüştürülür. Ajan kayda sesli yanıt verir.
promptisteğe bağlı
Türstring | null
≤ 20.000 karakter
Konuşma bağlamı sağlayan ve Grok'un varsayılanı yerine bir persona belirleyen isteğe bağlı sistem talimatları; belirtilmezse varsayılan persona korunur.
voiceisteğe bağlı
Türenum
carinazaganhelixorionlunairisaltairzenithperseusheliosluxkeplerrigelcosmocelesteursa
+12 tane dahasiriuslumencastornakshatlasauroralioraaraeveleorexsal
Ajanın yanıtında Grok'un varsayılanını geçersiz kılmak için yerleşik bir xAI sesi seçin; ayarlanmazsa varsayılan ses korunur.
toolsisteğe bağlı
Türobject
Varsayılan{"mcp_servers":[],"web_search":{"enabled":false},"x_search":{"enabled":false}}
Sunucu tarafında kullanım için ajan araç yapılandırması; ZDR nedeniyle file_search/collections yazımlı yapılandırmadan çıkarılır. Tüm araçlar başlangıçta devre dışıdır; desteklenen seçenekler arasında uzak MCP araçları, web araçları ve X araçları bulunur.
tools.mcp_serversisteğe bağlı
Türobject[]
Model sağlayıcısının araç yürütme için bağlandığı uzak MCP sunucuları.
tools.mcp_servers[].allowed_toolsisteğe bağlı
Türstring[]
≥ 1 items
Bu sunucunun sunduğu araç adlarını belirten isteğe bağlı liste.
tools.mcp_servers[].authorizationisteğe bağlı
Türstring | null
Yalnızca model sağlayıcısına gönderilen hassas yetkilendirme değeri.
tools.mcp_servers[].enabledisteğe bağlı
Türboolean
Varsayılantrue
Sunucu dahil etme bayrağı; false sunucuyu dışlar.
tools.mcp_servers[].headersisteğe bağlı
Türobject | null
Yalnızca model sağlayıcısına gönderilen MCP istekleri için hassas başlıklar.
tools.mcp_servers[].server_descriptionisteğe bağlı
Türstring | null
≤ 2000 characters
Bu sunucunun kullanıma sunduğu yetenekleri açıklayan açıklama.
tools.mcp_servers[].server_labelgerekli
Türstring
1 – 128 characters
Model sağlayıcısının araçlarını tanımlamak ve adlarının önüne ek koymak için kullandığı sunucu etiketi.
tools.mcp_servers[].server_urlgerekli
Türstring
≥ 1 characters
Grok'un Streaming HTTP/SSE aktarımları üzerinden uzaktan bağlandığı MCP sunucusu için çağıran tarafından sağlanan HTTP(S) adresi.
tools.web_search.allowed_domainsisteğe bağlı
Türstring[]
1 – 5 items
Arama sonuçları için alan adı kısıtlaması: protokolleri ve yolları çıkartarak en fazla beş alan adı belirtin.
tools.web_search.enable_image_understandingisteğe bağlı
Türboolean | null
Ajanın web aramalarında keşfedilen görselleri inceleme izni.
tools.web_search.enabledisteğe bağlı
Türboolean
Varsayılanfalse
Ajan için web araması erişimi: true, session.tools içine web_search ekler ve web aramalarına izin verir; varsayılan değer bunu devre dışı bırakır.
tools.web_search.excluded_domainsisteğe bağlı
Türstring[]
1 – 5 items
Arama sonuçlarından hariç tutulacak alan adları; protokoller ve yollar çıkarılarak en fazla beş girişle sınırlıdır.
tools.web_search.locationisteğe bağlı
Türobject
Arama sonuçlarını coğrafi olarak uyarlamak için isteğe bağlı konum.
tools.x_search.allowed_x_handlesisteğe bağlı
Türstring[]
1 – 20 items
Gönderileri sonuçlarda görünebilecek X kullanıcı adları; 20 kullanıcı adıyla sınırlıdır.
tools.x_search.enable_image_understandingisteğe bağlı
Türboolean | null
Ajanın X üzerinde keşfedilen görselleri inceleme izni.
tools.x_search.enable_video_understandingisteğe bağlı
Türboolean | null
Ajanın X üzerinde keşfedilen videoları inceleme izni.
tools.x_search.enabledisteğe bağlı
Türboolean
Varsayılanfalse
Arama yoluyla X gönderilerine erişim: true, ajanın bu gönderilerde arama yapabilmesi için session.tools içine x_search ekler; varsayılan değer bunu devre dışı bırakır.
tools.x_search.excluded_x_handlesisteğe bağlı
Türstring[]
1 – 20 items
Gönderileri hariç tutulan X kullanıcı adları; 20 kullanıcı adıyla sınırlıdır.
tools.x_search.from_dateisteğe bağlı
Türstring | null
Gönderiler için ISO biçiminde YYYY-MM-DD olarak ifade edilen en erken tarih.
tools.x_search.to_dateisteğe bağlı
Türstring | null
Gönderiler için ISO biçiminde YYYY-MM-DD olarak ifade edilen en geç tarih.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Çağıran yetkiliyse false ayarlanarak tarama gevşetilebilir.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-voice",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1494,
    "usd": "1.494",
    "charged": 1494,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "text": "",
    "duration": 5
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
audio
object {url, content_type, file_name, file_size}Grok ajanının 24 kHz'de mono WAV olarak iletilen sözlü yanıtı.
text
stringAjanın konuşmasına eşlik eden metin: boş dize, Grok'un bir transkript sağlamadığını belirtir; aksi takdirde transkripti içerir.
duration
numberSaniye cinsinden ölçülen üretilen ses uzunluğu.

Daha fazla model: Ses

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/xai/grok-voice.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt