Get Started

Authentication

All Resemble API endpoints use the same authentication method. Your API key works across supported Resemble API servers.

Getting Your API Key

Create or retrieve your API key from the Account → API page.

Authentication Format

Protected requests require a Bearer token in the Authorization header:

1Authorization: Bearer <API_KEY>

Servers

Resemble uses different servers depending on the endpoint type:

ServerBase URLPurpose
Synthesishttps://f.cluster.resemble.aiText-to-Speech, Speech-to-Speech
APIhttps://app.resemble.ai/api/v2Voices, projects, clips, recordings, Detect Agents, etc.
Billinghttps://app.resemble.ai/billing/api/v1Plans, subscriptions, adjustable products, and wallet
Detection streamingwss://stream.resemble.aiReal-time audio Deepfake Detection

Synthesis Server Example

$curl --request POST "https://f.cluster.resemble.ai/synthesize" \
>  -H "Authorization: Bearer YOUR_API_KEY" \
>  -H "Content-Type: application/json" \
>  --data '{
>    "voice_uuid": "YOUR_VOICE_UUID",
>    "data": "Hello from Resemble!"
>  }'

API Server Example

$curl 'https://app.resemble.ai/api/v2/voices' \
>  -H 'Authorization: Bearer <API_KEY>'

Billing Server Example

$export RESEMBLE_API_KEY="your_api_key"
$
$curl 'https://app.resemble.ai/billing/api/v1/subscription' \
>  -H "Authorization: Bearer $RESEMBLE_API_KEY"

SDK Configuration

The SDKs handle authentication automatically once you set your API key:

Node.js

1import { Resemble } from "@resemble/node";
2
3Resemble.setApiKey("YOUR_API_KEY");

Python

1from resemble import Resemble
2
3Resemble.api_key("YOUR_API_KEY")

Store tokens securely and rotate them according to your security policies.