canonical: https://jentic.com/apis/resemble.ai/resemble

# Resemble API Reference

The Resemble AI API synthesizes speech from text or SSML in cloned and library voices, synchronously or as an HTTP stream, and builds custom voices from uploaded recordings or from a text prompt through voice design. It also transcribes audio and answers questions about a transcript, edits and enhances audio, and runs deepfake detection on a media url with optional audio source tracing and follow-up questions. Further operations apply and detect audio watermarks, search speaker identities, run phone-dispatched voice agents with tools, webhooks, and knowledge items, and manage pronunciations, term substitutions, projects, and clips.

## For AI agents

Generate speech in cloned or library voices, build custom voices, transcribe audio, detect deepfakes and watermarks, and dispatch Resemble voice agents to phone numbers.

## Scope

Does not host podcasts, edit video, or translate text between languages. Use for Resemble speech synthesis, voice creation, transcription, deepfake and watermark detection, and voice agents only.

## Capabilities

- Synthesize up to 3,000 characters of text or SSML in a chosen voice_uuid, with an optional chatterbox-turbo model for lower latency
- Stream synthesized speech over HTTP for real-time playback
- Build a custom voice from uploaded recordings or generate voice candidates from a text user_prompt
- Run deepfake detection on an audio or video url, then ask follow-up questions about the result
- Apply an audio watermark to a file and detect watermarks in suspect media
- Transcribe audio and ask intelligence questions about a transcript
- Dispatch a Resemble voice agent to a phone_number with dynamic_variables, tools, and knowledge items

## Use cases

### Agent voiceover generation

An agent connected through Jentic turns a script into audio by calling the synchronous synthesis operation with a voice_uuid and the text or SSML in data, choosing output_format and sample_rate. Longer narration is split into chunks under the 3,000-character limit, and custom pronunciations can be applied with apply_custom_pronunciations.

Example prompt: Call POST /synthesize with voice_uuid set to the brand voice and data set to the first 3,000-character chunk of the script

### Deepfake screening

Trust and safety teams submit a media url to the detection operation, optionally with audio_source_tracing or a callback_url, then read the result and ask questions about it through the detection intelligence operations. Watermark detection adds a second check for content produced with Resemble watermarking.

Example prompt: Call POST /detect with url set to the suspect clip, then GET `/detect/{uuid}` until the result is ready

### Phone voice agents

Teams create a Resemble agent with a voice, attach tools, webhooks, and knowledge items, and dispatch it to a phone_number with dynamic_variables for the call. Agent phone numbers are managed through their own operations.

Example prompt: Call POST `/agents/{uuid}/dispatch` with phone_number set to +15551234567 and dynamic_variables carrying the customer's first name

### Custom voice creation

A product team creates a voice by name, uploads recordings to it, and triggers a build, or generates candidates from a user_prompt with voice design and promotes one to a voice.

Example prompt: Call POST /voice-design with user_prompt set to 'calm older male narrator', then POST `/voice-design/create` with the chosen candidate

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/synthesize` | Synchronous text-to-speech synthesis |
| POST | `/stream` | Streaming text-to-speech over HTTP |
| POST | `/voices` | Create a voice |
| POST | `/voice-design` | Generate voice candidates from a prompt |
| POST | `/detect` | Create a deepfake detection |
| POST | `/watermark/apply` | Apply an audio watermark |
| POST | `/speech-to-text` | Create a transcript job |
| POST | `/agents/{uuid}/dispatch` | Dispatch a voice agent to a phone number |

## Key resources

- **Synthesis** — Synchronous and streaming text-to-speech
- **Voices** — Custom and library voices, recordings, builds, and voice design candidates
- **Detection** — Deepfake detection, intelligence questions, and audio source tracing
- **Watermarks** — Apply and detect audio watermarks
- **Speech-to-text** — Transcripts and transcript questions
- **Agents** — Voice agents with tools, webhooks, knowledge items, phone numbers, and dispatch
- **Projects and clips** — Projects containing generated clips

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 56 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 44 / 100
  - Developer Experience & Jentic Compatibility: 57 / 100
  - AI-Readiness & Agent Experience: 48 / 100
  - Agent Usability: 82 / 100
  - Security: 60 / 100
  - AI Discoverability: 67 / 100
- **View full report:** https://jentic.com/apis/resemble.ai/resemble/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Resemble by hand means sending its bearer token on each call, choosing between the f.cluster.resemble.ai and app.resemble.ai hosts, chunking text under the 3,000-character synthesis limit, and polling detection, transcript, and watermark jobs. Through Jentic you install once, import Resemble AI from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Synthesis takes its voice_uuid in the request body, so rules bound which operations your agent may use there, not which voice. Agents, voices, and projects carry their ids in the URL path (`/agents/{uuid}/dispatch`, `/voices/{voice_uuid}`), so a rule can tie the agent to one of them, and destructive ones like voice or project deletion are not included unless you add them.
- **Credential handling:** Your Resemble API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'read text aloud in a cloned voice' or 'check if audio is a deepfake', and Jentic returns the matching Resemble operation with its input schema so the agent sends the right voice_uuid, url, or phone_number.

## Related APIs

- **ElevenLabs API** — Text-to-speech, voice cloning, and voice agents
- **Play.ht Text to Speech API** — Text-to-speech with cloned voices
- **Deepgram API** — Speech recognition and audio intelligence
- **AssemblyAI API** — Speech-to-text with audio intelligence

## FAQ

### What authentication does the Resemble AI API use?

Per its OpenAPI spec, the Resemble AI API authenticates with an HTTP bearer API token sent in the Authorization header, and each operation also declares that header as a required parameter. Tokens come from the API page of your Resemble account. Through Jentic, the token is stored encrypted by your own Jentic One instance and injected at execution time.

### How much text can I synthesize in one Resemble call?

POST /synthesize takes up to 3,000 characters of text or SSML in data, plus a required voice_uuid. Optional fields include model, output_format, sample_rate, precision, use_hd, and project_uuid. For real-time playback use POST /stream instead.

### Can I detect deepfakes with the Resemble AI API?

Yes. POST /detect takes a media url and options such as audio_source_tracing, zero_retention_mode, and callback_url, and GET `/detect/{uuid}` returns the result. You can then ask questions about a detection with POST `/detects/{uuid}/intelligence.`

### What are the rate limits for the Resemble AI API?

The OpenAPI spec does not publish rate limit numbers. Check https://docs.resemble.ai for current limits.

### How do I generate speech through Jentic?

Search Jentic for 'synthesize speech with Resemble'. Jentic returns POST /synthesize with its input schema; your agent sets voice_uuid and data, and Jentic sends the call with your stored token. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Resemble AI MCP server?

You don't need an MCP server to give your agent Resemble AI. Jentic connects it directly from the API Directory: import it, store your token once, and your agent finds the synthesis, detection, and agent operations by intent instead of loading all of their tool definitions into context.

### Can I limit what my agent is allowed to do with the Resemble AI API?

Yes. A narration agent could be allowed POST /synthesize, POST /stream, and GET /voices only, so it can speak in existing voices but cannot create or delete voices, dispatch phone agents, or remove projects. For a calling workflow, allow POST `/agents/{uuid}/dispatch` for one agent uuid.
