REST API
Authentication
Authenticate Cleanvoice API requests.
Get your API key
Go to app.cleanvoice.ai/developer/api-keys and create a new key.
Pass the key in the header
Every request must include an X-API-Key header:
curl https://api.cleanvoice.ai/v2/edits \
-H "X-API-Key: $CLEANVOICE_API_KEY"Store the key in an environment variable and reference it rather than pasting it directly into commands:
export CLEANVOICE_API_KEY="your_api_key_here"Verify your key
curl https://api.cleanvoice.ai/v2/auth \
-H "X-API-Key: $CLEANVOICE_API_KEY"Returns your account information and remaining credits if the key is valid.
Error responses
| Status | Meaning |
|---|---|
401 Unauthorized | API key is missing or malformed |
403 Forbidden | API key is valid but does not have permission for this action (e.g. insufficient credits) |
Keep your API key secret. Never commit it to source control, include it in client-side code, or expose it in public URLs. Use environment variables or a secrets manager.