Quickstart
Get up and running with Wave Form API in minutes.
Step 1: Get Your API Key
Navigate to the developer dashboard and create an API key. Keep it secure - you'll need it for all API requests.
Your API key will look like: wf_xxxxxxxxxxxx
Step 2: Make Your First Request
Test the API with a simple cURL command
curl -X POST https://wave-form-api.onrender.com/tts/synthesize \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Hello! [laugh] (excited)",
"provider_id": "cartesia",
"voice_id": "voice-id"
}'Step 3: Decode the Audio
The API returns base64-encoded MP3 audio
import requests
import base64
response = requests.post(
'https://wave-form-api.onrender.com/tts/synthesize',
headers={'X-API-Key': 'YOUR_API_KEY'},
json={
'text': 'Hello! [laugh] (excited)',
'provider_id': 'cartesia',
'voice_id': 'voice-id'
}
)
if response.status_code == 200:
audio = base64.b64decode(response.json()['audio'])
with open('output.mp3', 'wb') as f:
f.write(audio)
else:
print(f"Error: {response.status_code} - {response.text}")