Developer documentation

Not verified

Speech translation API reference

Speech translation is configured with a translation object on realtime sessions or offline audio jobs. There is no pure text translation endpoint.

Interface example

Start with a request.
Inspect every field.

Use a project API key from your server and follow the capability status documented on this page.

curl https://api.audelyr.ai/v1/realtime/sessions \
  -H "Authorization: Bearer $AUDELYR_API_KEY" \
  -H "Idempotency-Key: translation-demo-001" \
  -H "Content-Type: application/json" \
  -d '{"audio":{"format":"pcm_s16le","sample_rate_hz":16000,"channels":1},"translation":{"mode":"one_way","target_language":"zh-CN"}}'

Integration reference

Endpoints, parameters
and response contracts.

Production base URL: https://api.audelyr.ai. Keep API keys on your server. Every POST that creates work accepts an Idempotency-Key; reuse the same key only with the same request body.

POSThttps://api.audelyr.ai/v1/realtime/sessions

Enable speech translation for a realtime audio session.

Auth: Bearer aud_live_… (server only)

Headers: Idempotency-Key · Content-Type: application/json

audioobjectyesMono PCM16 or WebM Opus input.
translationobjectyesUse {mode: one_way, target_language} or {mode: bidirectional, languages: [a, b]}.

Response: 201 session credentials; WebSocket emits transcript.final and translation.final.

POSThttps://api.audelyr.ai/v1/transcriptions

Queue an offline audio transcription with optional speech translation.

Auth: Bearer aud_live_… (server only)

Headers: Idempotency-Key · Content-Type: application/json

audio_url|file_idstringyesExactly one HTTPS audio URL or file reference.
translationobjectnoOptional one-way target or bidirectional language pair for speech translation.

Response: 202 job; completed result includes transcript and translated_text.

01

Overview

Speech translation is configured with a translation object on realtime sessions or offline audio jobs. There is no pure text translation endpoint.

02

Before you begin

Create a project API key in the console and keep it on your server.

03

Request lifecycle

Realtime connections return events as audio is processed. HTTP and SSE endpoints return structured errors when a request cannot run.

04

Availability

Each guide states whether its capability is available today or still planned. Do not send production traffic to an endpoint marked unavailable.

Early Access

Build the interface
before the infrastructure.

Explore the honest Preview, then tell us what production voice needs from Audelyr.