Skip to main content

Voice Models

Explore and select from our library of professional voice models for your audio conversions.

Overview​

Voice models are the foundation of VoiceByAuribus conversions. Each model represents a unique voice with distinct characteristics that will be applied to your source audio while preserving the original content and timing.

Listing Voice Models​

Retrieve the complete list of available voices:

curl -X GET https://api.auribus.io/api/v1/voices \
  -H "Authorization: Bearer $TOKEN"

Response:

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Sarah Mitchell",
      "tags": ["female", "professional", "narration", "clear"],
      "image_url": "https://cdn.example.com/voices/sarah-mitchell/image.jpg?signature=...",
      "song_url": "https://cdn.example.com/voices/sarah-mitchell/preview.mp3?signature=..."
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Marcus Johnson",
      "tags": ["male", "deep", "authoritative", "announcer"],
      "image_url": "https://cdn.example.com/voices/marcus-johnson/image.jpg?signature=...",
      "song_url": "https://cdn.example.com/voices/marcus-johnson/preview.mp3?signature=..."
    }
  ]
}

Response Fields​

FieldDescription
idUnique identifier for the voice model (use this in conversion requests)
nameDisplay name of the voice model
tagsDescriptive tags for filtering and categorization (e.g., gender, style, use case)
image_urlPre-signed URL to the voice model profile image (time-limited; refetch to refresh)
song_urlPre-signed URL to the audio preview sample (time-limited; refetch to refresh)

Getting Voice Model Details​

Retrieve detailed information about a specific voice model:

curl -X GET https://api.auribus.io/api/v1/voices/{id} \
  -H "Authorization: Bearer $TOKEN"

Example:

curl -X GET https://api.auribus.io/api/v1/voices/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer $TOKEN"

Response:

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Sarah Mitchell",
    "tags": ["female", "professional", "narration", "clear"],
    "image_url": "https://cdn.example.com/voices/sarah-mitchell/image.jpg?signature=...",
    "song_url": "https://cdn.example.com/voices/sarah-mitchell/preview.mp3?signature=..."
  }
}

Previewing Voice Models​

Before selecting a voice model for your conversion, listen to the audio preview:

  1. Get the list of available voices
  2. Note the song_url for voices you're interested in
  3. Play the audio preview to hear the voice model singing
  4. Copy the id of your chosen voice model for the conversion request
Best Practice

Always listen to the song_url preview before creating conversions. This helps you select the voice that best matches your desired output style and quality.

Next Steps​