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:

Authorization: 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

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

Python

from resemble import Resemble
Resemble.api_key("YOUR_API_KEY")

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