Translate an audio file

Live

Upload a recording and get it back in another language, spoken in your own voice or a stock voice, with the transcript and the translation.

$0.3597/minFailed steps are not charged

$0.3597/min

Audio fileaudio_url

cafe-thai-input-d800437a.mp3

A public https link or an upload.

Spoken in

Heard in

Voice

Clone my voice

The exact price shows once the file's length is read.

Example runAn example translation

Thai to English · A real run of this tool. Your own run replaces it.

What was said

0:00 / 0:00

Captions

สวัสดีค่ะ ยินดีต้อนรับสู่ร้านกาแฟของเรา วันนี้เรามีเค้กช็อกโกแลตตอบใหม่ๆ ลองชิมดูไหมคะHello, and welcome to our coffee shop. Today we have fresh chocolate cakes. Want to try them?

Translated voice

0:00 / 0:00

More voice tools

Each one is its own endpoint with its own price. Use one, or chain them.

Translate an audio file API

Send a link to an audio file; get a task that returns the translated speech, the transcript and the translation.

POSThttps://api.opennan.com/v1/audio/translations

GET/v1/tasks/{id}Check a translation task

Get an API key
Create a key in the console. It uses the same balance as the playground.
Create a key

Send your first request

The same request the playground sends. Set OPENNAN_KEY to your key.

curl https://api.opennan.com/v1/audio/translations \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url":"https://example.com/talk.mp3","source_lang":"auto","target_lang":"en","voice_id":"vc_your_voice"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

Poll the task
The call answers right away with a task id. Ask for the task until it finishes:
GEThttps://api.opennan.com/v1/tasks/{id}
queued
Waiting for a worker
running
Being made
succeeded
Done: outputs[].url holds the files
failed
Failed: you are not charged

Errors and how to fix them

401Missing or wrong key
Send the header Authorization: Bearer with a key from the console.
402Balance too low
Add credit in Billing, then send the same call again.
400A value is not accepted
Read error.message: it names the field. Use a value from the parameter table.
429Too many requests
Wait a few seconds and try again, waiting longer after each 429.

Add Opennan to your AI app

One install gives your AI every Opennan tool: video, images, chat, voice, music, sound effects, 3D, captions and dubbing. Pick your app and follow the steps.

MCP serverhttps://api.opennan.com/v1/mcp

Works in the Codex CLI, the Codex app and the Codex IDE extension: they share ~/.codex/config.toml. If the app or IDE does not see OPENNAN_KEY, use the config.toml option with your key in it. Codex asks before each tool call: approve it to go on.

Get an API key
Create a key in the console. It starts with sk- and uses the same balance as the website.
Create a key

Save your key as OPENNAN_KEY

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
Install the Opennan plugin: the server plus a skill that teaches your AI to pick models, confirm prices and wait for results
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

Or add only the server

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

Or add this to ~/.codex/config.toml

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
Check that opennan is listed
```
codex mcp list
```
Restart Codex, then ask for anything
“Make a 5 second video of rain on a neon street, a song to go with it and a poster image.”

Replace sk-... with your own key and keep it private: anyone who has it can spend your balance. Your app can list the tools before you add a key; making anything needs one.

This tool from your AI

Once Opennan is added, your AI calls this tool with arguments like these.

Tool: translate_audio
Example arguments: { "audio_url": "https://example.com/talk.mp3", "target_lang": "en", "voice_id": "vc_your_voice" }

Translate an audio file: questions

What does Translate an audio file cost?

$0.3597/min of input audio. A failed task is not charged.

How do I call it?

Send POST https://api.opennan.com/v1/audio/translations with your API key. It returns a task; poll https://api.opennan.com/v1/tasks/{id} until it is succeeded or failed.

Am I charged when something fails?

No. A step that fails is not charged, and the reason is shown in plain words.

Can I use someone else's voice?

No. You can clone only your own voice, with a recording of you reading a consent sentence we give you. Voices are never shared between accounts.

Can my AI agent use it?

Yes. Point it at the MCP server https://api.opennan.com/v1/mcp (tool translate_audio), or have it read https://api.opennan.com/llms.txt.

Translate an audio file

More voice tools

Translate an audio file API

Get an API key

Send your first request

Poll the task

Errors and how to fix them

Add Opennan to your AI app

This tool from your AI

Translate an audio file: questions