Use Parrot STT through the TrueFoundry AI Gateway

TrueFoundry AI Gateway is a proxy between your applications and model providers: your teams get its access control and tracing instead of calling Ringg directly. To call Parrot without a gateway, use the Python SDK; the model itself is described on the Parrot STT model page.

Before you start

A Ringg API key

The gateway sends it to Ringg on every request.

TrueFoundry AI Gateway access

Permission to add Custom Endpoints.

Add Parrot STT as a Custom Endpoint

Create a Custom Endpoint provider account

In TrueFoundry, go to AI Gateway → Models → Custom Endpoints and click Add Custom Endpoint. Under Configure Account, set:

Name: a unique name. It becomes {providerAccountName} in the request URL.
Endpoint Type: None, or any value you use for tracking.
Header Auth: leave it disabled.

Add the Ringg endpoint

Click Add Endpoint and set:

Display Name: any name. It becomes {endpointName} in the request URL.
Base URL: https://prod-api.ringg.ai/stt/v1/transcriptions

Turn on Custom Headers and add x-api-key with your Ringg API key as the value. Keep Header Auth disabled.

TrueFoundry Custom Endpoint form for Ringg AI STT with the Base URL and an x-api-key custom header — Endpoint settings: Base URL and the x-api-key header

Your clients send only their TrueFoundry API key to the gateway.

Set access and save

On Access Control, add the users or teams who may use this provider account, then click Save.

Transcribe through the gateway

Call the endpoint at {GATEWAY_BASE_URL}/proxy-api/{providerAccountName}/{endpointName} (finding the gateway base URL). Send a multipart form with the audio in file and optional fields such as language and enable_cap_punc.

Transcribe through the gateway

import os
import requests

GATEWAY_BASE_URL = os.environ["TFY_GATEWAY_BASE_URL"]
TFY_API_KEY = os.environ["TFY_API_KEY"]
PROVIDER_ACCOUNT = "ringg"        # the Custom Endpoint account name
ENDPOINT_NAME = "parrot-stt"      # the endpoint's display name

url = f"{GATEWAY_BASE_URL}/proxy-api/{PROVIDER_ACCOUNT}/{ENDPOINT_NAME}"

with open("audio.mp3", "rb") as audio:
    response = requests.post(
        url,
        headers={"Authorization": f"Bearer {TFY_API_KEY}"},
        files={"file": audio},
        data={"language": "hi", "enable_cap_punc": "false"},
        timeout=120,
    )

response.raise_for_status()
print(response.json())

API	Endpoint	Tracing	Cost tracking
Speech-to-text	`/proxy-api/{providerAccountName}/{endpointName}`	Yes	No

Only HTTPS, non-streaming requests work through this integration. For live streaming, use the Python SDK’s streaming mode directly. To ask TrueFoundry for more endpoints, email support@truefoundry.com.

Build agents

Inventory

Deploy

Monitor

Manage account

Ringg Labs

Parrot STT on TrueFoundry

Before you start

A Ringg API key

TrueFoundry AI Gateway access

Add Parrot STT as a Custom Endpoint

Transcribe through the gateway

Next steps

Parrot STT Python SDK

TrueFoundry Custom Endpoints

​Before you start

A Ringg API key

TrueFoundry AI Gateway access

​Add Parrot STT as a Custom Endpoint

​Transcribe through the gateway

​Next steps

Parrot STT Python SDK

TrueFoundry Custom Endpoints

Before you start

Add Parrot STT as a Custom Endpoint

Transcribe through the gateway

Next steps