Voices

Primary agent path

Use the Universal Skill with the MCP tool beatra.voices.list. It is a non-billable, read-only call that returns preset and tenant-owned cloned voices.

Filter by category (preset / cloned), language (BCP-47), gender, or query (search by name).
Use the returned voice_id directly as the voice field in text to speech; preview_url lets the user listen to a sample before choosing.

AI guide

MCP integration guide for AI

For custom API integrations, copy this guide into Claude, Codex, or another coding assistant.

Markdown

Tool arguments

{
  "category": "preset",
  "language": "zh-CN"
}

A voice entry looks like:

{
  "voice_id": "voice_01JX...",
  "display_name": "Sunny female voice",
  "category": "preset",
  "language": "zh-CN",
  "gender": "female",
  "preview_url": "https://cdn.beatra.ai/.../preview.mp3",
  "status": "ready"
}

Deleting a cloned voice

Deletion is REST-only:

curl -X DELETE "$BEATRA_BASE_URL/voices/voice_01JX..." \
  -H "Authorization: Bearer $BEATRA_API_KEY"

Returns 204. Only voices you cloned yourself can be deleted; preset voices cannot.

REST API

Direct protocol integrations may use the voice endpoints directly: List · Retrieve · Delete. Skill + MCP is the recommended integration; use REST for custom, non-agent applications.