Audio

Speech (text-to-speech)

Returns audio bytes. The gateway streams the provider's response through without buffering (chunked transfer), so playback can start before synthesis finishes.

curl "https://api.smartapihub.com/v1/audio/speech" \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/tts-1",
    "input": "The gateway routes each request to the best available provider.",
    "voice": "alloy",
    "response_format": "mp3",
    "speed": 1.0
  }' --output speech.mp3

Response headers include X-Request-Id, X-LLM-Provider, X-LLM-Model, X-LLM-Routing-Reason and X-LLM-Cost-Micro. Speech is priced per character or per audio second depending on the model (see the model's pricing keys).

Streaming behaviour

• Headers are sent as soon as the provider starts responding; bytes are forwarded as they arrive.
• Retries and fallback apply only before the first byte is forwarded. A provider failure after that closes the connection early; check that the received byte count matches Content-Length when the provider supplies one, or that the container decodes cleanly.
• Idempotency-Key is accepted (optional).

const res = await client.audio.speech.create({
  model: 'openai/tts-1',
  voice: 'alloy',
  input: 'Hello from the gateway.',
  response_format: 'mp3',
});
await fs.promises.writeFile('speech.mp3', Buffer.from(await res.arrayBuffer()));

with client.audio.speech.with_streaming_response.create(
    model="openai/tts-1", voice="alloy", input="Hello from the gateway."
) as response:
    response.stream_to_file("speech.mp3")

Transcriptions (speech-to-text)

Upload an audio file as multipart/form-data.

curl "https://api.smartapihub.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -F model="openai/whisper-1" \
  -F file=@meeting.mp3 \
  -F language=en \
  -F response_format=json

Response for json:

{ "text": "Welcome everyone, let's get started with the roadmap review." }

verbose_json additionally returns language, duration and segments[] where the provider supplies them. Transcription is priced per audio second.

const transcription = await client.audio.transcriptions.create({
  model: 'openai/whisper-1',
  file: fs.createReadStream('meeting.mp3'),
});
console.log(transcription.text);

with open("meeting.mp3", "rb") as f:
    transcription = client.audio.transcriptions.create(model="openai/whisper-1", file=f)
print(transcription.text)

Errors