Naar inhoud springen

Grok Voice · Realtime

Integreren

Model-ID xai/grok-voice/realtime
# 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/realtime?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"

Tot $ 1,494 per uitvoering gefactureerd op basis van het werkelijke gebruik, de rest wordt terugbetaald Op deze pagina uitvoeren

API-sleutel ophalen
xAI Audio #xai#grok#voice#agent

Realtime variant van de Grok voice agent voor streaming, bidirectionele audio- en tekstgesprekken

xAI · Audio

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

0 / 20000

Optionele systeeminstructies die gesprekscontext leveren en een persona specificeren in plaats van de standaardpersona van Grok; weglaten behoudt die standaardpersona.

•verplicht audio_url
Sleep een bestand hierheen of

Audio-URL voor de spraak van de gebruiker, beperkt tot 10 minuten en 50 MB. De meeste gangbare audio-indelingen kunnen worden aangeleverd; voordat Grok de audio ontvangt, wordt deze geconverteerd naar mono PCM met 16-bits samples bij 24 kHz. De agent reageert met spraak op de opname.

Geavanceerd voice · enable_safety_checker · tools

Selecteer een ingebouwde xAI-stem om de standaardstem van Grok voor het antwoord van de agent te overschrijven; als je deze niet instelt, blijft die standaardstem behouden.

standaard {"mcp_servers":[],"we...

Agenttoolconfiguratie voor gebruik aan de serverzijde, waarbij file_search/collections vanwege ZDR uit de getypeerde configuratie zijn weggelaten. Alle tools zijn aanvankelijk uitgeschakeld; ondersteunde opties zijn externe MCP-tools, webtools en X-tools.

POST /run/xai/grok-voice/realtime?wait=20 prijsopgave → $ 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/realtime?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"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Grok Voice · Realtime

Spraakagent voor live toepassingen zoals assistenten en telefoonagents, opgebouwd rond streaming audio en tekst in beide richtingen. De invoer komt overeen met het standaard spraakmodel: `audio_url` voor de spraak van de gebruiker, een optionele persona-instructie in `prompt`, een `voice`-keuze en optionele `tools` voor web-, X- of MCP-toegang. Retourneert gesproken WAV-audio, de duur ervan en een transcriptie.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
audio_urlverplicht audio
Typeurl · audio
Audio-URL voor de spraak van de gebruiker, beperkt tot 10 minuten en 50 MB. De meeste gangbare audio-indelingen kunnen worden aangeleverd; voordat Grok de audio ontvangt, wordt deze geconverteerd naar mono PCM met 16-bits samples bij 24 kHz. De agent reageert met spraak op de opname.
promptoptioneel
Typestring | null
≤ 20.000 tekens
Optionele systeeminstructies die gesprekscontext leveren en een persona specificeren in plaats van de standaardpersona van Grok; weglaten behoudt die standaardpersona.
voiceoptioneel
Typeenum
carinazaganhelixorionlunairisaltairzenithperseusheliosluxkeplerrigelcosmocelesteursa
+12 meersiriuslumencastornakshatlasauroralioraaraeveleorexsal
Selecteer een ingebouwde xAI-stem om de standaardstem van Grok voor het antwoord van de agent te overschrijven; als je deze niet instelt, blijft die standaardstem behouden.
toolsoptioneel
Typeobject
Standaard{"mcp_servers":[],"web_search":{"enabled":false},"x_search":{"enabled":false}}
Agenttoolconfiguratie voor gebruik aan de serverzijde, waarbij file_search/collections vanwege ZDR uit de getypeerde configuratie zijn weggelaten. Alle tools zijn aanvankelijk uitgeschakeld; ondersteunde opties zijn externe MCP-tools, webtools en X-tools.
tools.mcp_serversoptioneel
Typeobject[]
Externe MCP-servers waarmee de modelprovider verbinding maakt voor de uitvoering van tools.
tools.mcp_servers[].allowed_toolsoptioneel
Typestring[]
≥ 1 items
Optionele lijst die specificeert welke toolnamen deze server beschikbaar stelt.
tools.mcp_servers[].authorizationoptioneel
Typestring | null
Gevoelige autorisatiewaarde die uitsluitend naar de modelprovider wordt verzonden.
tools.mcp_servers[].enabledoptioneel
Typeboolean
Standaardtrue
Opnamevlag voor de server; false sluit de server uit.
tools.mcp_servers[].headersoptioneel
Typeobject | null
Gevoelige headers voor MCP-requests, uitsluitend naar de modelprovider verzonden.
tools.mcp_servers[].server_descriptionoptioneel
Typestring | null
≤ 2000 characters
Beschrijving van de mogelijkheden die deze server beschikbaar stelt.
tools.mcp_servers[].server_labelverplicht
Typestring
1 – 128 characters
Serverlabel dat de modelprovider gebruikt om de tools te identificeren en hun namen van een prefix te voorzien.
tools.mcp_servers[].server_urlverplicht
Typestring
≥ 1 characters
HTTP(S)-adres dat door de aanroeper wordt aangeleverd voor een MCP-server waarmee Grok op afstand verbinding maakt via Streaming HTTP/SSE-transporten.
tools.web_search.allowed_domainsoptioneel
Typestring[]
1 – 5 items
Domeinbeperking voor zoekresultaten: geef maximaal vijf domeinen op, zonder protocollen en paden.
tools.web_search.enable_image_understandingoptioneel
Typeboolean | null
Toestemming voor de agent om afbeeldingen te bekijken die via webzoekopdrachten zijn gevonden.
tools.web_search.enabledoptioneel
Typeboolean
Standaardfalse
Toegang tot webzoekopdrachten voor de agent: true voegt web_search toe aan session.tools en staat webzoekopdrachten toe; de standaardwaarde laat dit uitgeschakeld.
tools.web_search.excluded_domainsoptioneel
Typestring[]
1 – 5 items
Domeinen die uit zoekresultaten moeten worden uitgesloten, beperkt tot vijf items zonder protocollen en paden.
tools.web_search.locationoptioneel
Typeobject
Optionele locatie om zoekresultaten geografisch af te stemmen.
tools.x_search.allowed_x_handlesoptioneel
Typestring[]
1 – 20 items
X-handles waarvan berichten in de resultaten mogen verschijnen, beperkt tot 20 handles.
tools.x_search.enable_image_understandingoptioneel
Typeboolean | null
Toestemming voor de agent om afbeeldingen te bekijken die op X zijn gevonden.
tools.x_search.enable_video_understandingoptioneel
Typeboolean | null
Toestemming voor de agent om video's te bekijken die op X zijn gevonden.
tools.x_search.enabledoptioneel
Typeboolean
Standaardfalse
Toegang tot X-berichten via zoeken: true voegt x_search toe aan session.tools, zodat de agent die berichten kan doorzoeken; de standaardwaarde laat dit uitgeschakeld.
tools.x_search.excluded_x_handlesoptioneel
Typestring[]
1 – 20 items
X-handles waarvan berichten worden uitgesloten, beperkt tot 20 handles.
tools.x_search.from_dateoptioneel
Typestring | null
Vroegste datum voor berichten, uitgedrukt in ISO-indeling YYYY-MM-DD.
tools.x_search.to_dateoptioneel
Typestring | null
Laatste datum voor berichten, uitgedrukt in ISO-indeling YYYY-MM-DD.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Screening kan worden versoepeld door false in te stellen, mits de aanroeper is geautoriseerd.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-voice/realtime",
  "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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
audio
object {url, content_type, file_name, file_size}Gesproken antwoord van de Grok-agent, geleverd als mono-WAV met 24 kHz.
text
stringTekst bij de spraak van de agent: een lege tekenreeks geeft aan dat Grok geen transcript heeft aangeleverd; anders bevat deze het transcript.
duration
numberDuur van de gegenereerde audio, gemeten in seconden.

Meer modellen: Audio

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/xai/grok-voice/realtime.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt