Skip to main content

​
Provider capabilities

The table below summarizes gateway support for this endpoint by provider.
Legend:
  • ✅ Supported by Provider and Truefoundry
  • Provided by provider, but not by Truefoundry
  • Provider does not support this feature
ProviderTranscription
OpenAI✅
Azure OpenAI✅
Azure AI Foundry✅
Anthropic
Bedrock
Vertex
Cohere
Gemini
Groq✅
Together-AI
xAI
DeepInfra
DeepGram✅
Cartesia✅
ElevenLabs✅
For every gateway endpoint and provider, see Supported APIs. Speech to text (STT) turns speech (audio files) into text. The gateway supports two ways to call it:
ApproachUse forBase path
OpenAI-compatible APIOpenAI, Azure OpenAI, Azure AI Foundry, Groq{GATEWAY_BASE_URL}
Provider proxy (native SDK)Deepgram, Cartesia, ElevenLabs, Vertex{GATEWAY_BASE_URL}/stt/{providerAccountName}

​
Add models to the gateway

Before you can call the Speech to Text API, add your STT models to TrueFoundry through a provider account. When adding a model, select Audio Transcription as the model type.
ProviderSetup guide
OpenAIOpenAI
Azure OpenAIAzure OpenAI
Azure AI FoundryAzure AI Foundry
GroqGroq
DeepgramDeepgram
CartesiaCartesia
ElevenLabsElevenLabs
VertexGoogle Vertex

​
Code snippets

Before you start: Replace {GATEWAY_BASE_URL} with your AI Gateway Base URL (how to find it) and your-tfy-api-key with your TrueFoundry API key. For the provider proxy, replace {providerAccountName} with the display name of your provider account on TrueFoundry.
Model names: For audio (STT/TTS), the model ID in code must match the display name of the model on your TrueFoundry provider account.
Which SDK to use: For OpenAI, Azure OpenAI, Azure AI Foundry, and Groq, use the OpenAI SDK (same API). For Deepgram, Cartesia, ElevenLabs, and Vertex, use each provider’s native SDK with the gateway URL above.
from openai import OpenAI

BASE_URL = "{GATEWAY_BASE_URL}"
API_KEY = "your-tfy-api-key"

client = OpenAI(
    api_key=API_KEY,
    base_url=BASE_URL,
)

with open("/path/to/audio.mp3", "rb") as audio_file:
    response = client.audio.transcriptions.create(
        model="openai-main/whisper-1",  # truefoundry model name
        file=audio_file,
    )

print(response)

​
Response

The shape of the response depends on the provider. Use print(response) to inspect it, or refer to each provider’s SDK docs for the exact structure.