Skip to main content
POST
/
{guru_type}
/
text-to-speech
/
stream
curl --request POST \
  --url https://api.gurubase.io/api/v1/{guru_slug}/text-to-speech/stream/ \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "Hello, this is a test message with some code: `console.log(\"hello\")` and a code block:\n```python\ndef hello():\n    print(\"hello\")\n```"
  }'

{
  "msg": "No text provided"
}

Documentation Index

Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt

Use this file to discover all available pages before exploring further.

Convert text to speech and stream the audio response. This endpoint processes text by replacing code blocks with “Code block” and inline code with “Inline code” before generating speech. 
curl --request POST \
  --url https://api.gurubase.io/api/v1/{guru_slug}/text-to-speech/stream/ \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "Hello, this is a test message with some code: `console.log(\"hello\")` and a code block:\n```python\ndef hello():\n    print(\"hello\")\n```"
  }'

​
Path Parameters

​
guru_type
string
required
The guru type identifier for the text-to-speech request

​
Headers

​
x-api-key
string
required
Your API key for authentication. You can obtain your API key from the Gurubase dashboard.

​
Body Parameters

​
text
string
required
The text to convert to speech. Code blocks and inline code will be processed and replaced with “Code block” and “Inline code” respectively.

​
Response

The response is a streaming audio file in MP3 format.
​
audio_stream
audio/mpeg
Streaming audio response in MP3 format
{
  "msg": "No text provided"
}

​
Text Processing

The endpoint automatically processes text before converting to speech:
  • Code blocks: Any text wrapped in triple backticks (```) is replaced with “Code block”
  • Inline code: Any text wrapped in single backticks (`) is replaced with “Inline code”
This ensures that code syntax doesn’t interfere with speech generation and provides a better listening experience.

​
Streaming Response

The endpoint returns a streaming audio response with the following headers:
  • Content-Type: audio/mpeg
  • Cache-Control: no-cache
  • X-Accel-Buffering: no (disables nginx buffering for real-time streaming)