Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

Use this file to discover all available pages before exploring further.

The Supertone API uses an API-key authentication scheme with a custom header. 
x-sup-api-key: <YOUR_API_KEY>
Include this header on every request. Missing or invalid keys return 401 Unauthorized; keys without permission for the resource return 403 Forbidden.

​
Issue a key

Sign in at the developer console and create a new key. You can have up to 3 active keys per account; revoke and reissue from the console at any time.

​
Example

curl https://supertoneapi.com/v1/voices \
  -H "x-sup-api-key: $SUPERTONE_API_KEY"

​
Authentication errors

StatusCause
401 UnauthorizedMissing, malformed, or revoked API key.
403 ForbiddenValid key, but no permission for the resource (e.g. calling a custom voice owned by a different account).
For the full error catalog and recommended responses, see Error handling.

​
See also

Docs: Authentication

Setup walkthrough, env-var conventions, and security checklist.

Quickstart

Set your key and make your first call in five minutes.