Docs
Open dashboard

Get voice

GET/voices/{voice_id}

Look up a voice by its runtime ID (e.g. fish/abc123) or bare provider ID. Not paywalled — voice lookup is always available.

Requires Authorization: Bearer <api_key>. Create a key in the Inspra dashboard under Workspace Settings → API Keys.

Path parameters

  • voice_idstringrequired
    Runtime voice ID (e.g. fish/abc123).

Response 200 OK

Voice details.

  • idstringrequired
    Runtime voice ID (e.g. fish/abc123). Use this value when setting an agent's voice.
  • providerstringrequired
  • namestringrequired
  • descriptionstringrequired
  • languagestringrequired
  • language_labelsstring[]required
  • accentstringnullableoptional
  • accent_labelsstring[]optional
  • genderstringrequired
    FemaleMaleUnspecified
  • agestringrequired
  • stylesstring[]required
  • tagsstring[]required
  • preview_urlstringnullableoptional
  • avatar_urlstringnullableoptional
  • default_tts_modelstringrequired

Errors

  • 401Unauthorized
    Missing, malformed, or invalid API key.
  • 403Forbidden
    Workspace unavailable, suspended, or paywalled.
  • 404Not Found
    Resource not found in this workspace.
  • 429Too Many Requests
    Workspace request limit exceeded; shared across all its API keys.