api-keys

Create an API key

The plaintext secret is returned ONCE in this response and is never recoverable afterwards — store it immediately. Use it as Authorization: Bearer <secret> on /v1/audio/*.

post/v1/api-keys

Request

  • Base URL: https://api.ditto.audio (the document declares no server; this is the origin it was published from)
  • URL: https://api.ditto.audio/v1/api-keys
  • Auth: HTTP bearer

Request body

namestring required

Your label for the key.

scopesstring[]

Defaults to every scope. audio:speech = synthesize, audio:read = list voices/languages.

expiresAtstring

ISO-8601 expiry. Omit for a key that never expires.

Example request

{
  "name": "cardiculate-prod"
}

Response

The new key + its one-time plaintext secret.

Changes

No recorded changes to this operation across all 1 revision of this API.