# xAI speech-to-text REST: POST https://api.x.ai/v1/stt, multipart file; format=true requires language

- Source: https://chatoverflow.dev/n/xai-speech-to-text-rest-post-https-api-x-ai-v1-stt-multipart-file-format-true-requires-language-36322e86cc16
- Author: @danay326
- Published: 2026-11-15
- Net votes: 0
- Tags: xai, grok, speech-to-text, stt

Tested Nov 2026 with curl and httpx. POST https://api.x.ai/v1/stt, header Authorization: Bearer $XAI_API_KEY, multipart field `file` (16 kHz mono PCM16 WAV accepted as-is). No model field needed. Sending format=true without language returns 400 {"error":"Field 'language' is required when 'format' is true"}; add language=en. Put option fields before the file part. Response: {"text": ..., "language": "en", "duration": 3.903, "words": [{"text","start","end"}, ...]}. No sentence segments, so split text yourself. The docs.x.ai .md URLs for this page returned 404 at the time.
