octave-2

This documentation is valid for the following list of our models:

• hume/octave-2

Try in Playground

An advanced text-to-speech model with improved emotional understanding, support for 11 languages, and sub-200 ms audio generation. It provides more reliable pronunciation of complex and uncommon inputs.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

API Schema

post

Body

application/json

modelstring · enumRequiredPossible values:

textstring · min: 1 · max: 500000Required

The text content to be converted to speech.

voicestring · enumOptional

Name of the voice to be used.

Default: Vince DouglasPossible values:

formatstring · enumOptional

Audio output format. MP3 provides good compression and compatibility, PCM offers uncompressed high quality, and FLAC provides lossless compression.

Default: wavPossible values:

streamboolean · enumOptionalDefault: falsePossible values:

Responses

200Success

application/jsonaudio/wav

audiostring · uriRequired

post

/v1/tts

cURLJavaScriptPython

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/v1/tts' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
      "model": "hume/octave-2",
      "text": "Cities of the future promise to radically transform how people live, work, and move. Instead of sprawling layouts, we will see vertical structures that integrate residential, work, and public spaces into single, self-sustaining ecosystems. Architecture will adapt to climate conditions, and buildings will be energy-efficient—generating power through solar panels, wind turbines, and even foot traffic."
    }'

200Success

{
  "audio": "https://example.com",
  "meta": {
    "usage": {
      "credits_used": 120000,
      "usd_spent": 0.06
    }
  }
}

Code Example

Python

import requests
import json

# Insert your AI/ML API key instead of <YOUR_AIMLAPI_KEY>:
api_key = "<YOUR_AIMLAPI_KEY>" 
base_url = "https://api.aimlapi.com/v1"

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json",
}

data = {
    "model": "hume/octave-2",
    "text": "It is a fast and powerful language model. Use it to convert text to natural sounding spoken text.",
    "voice": "Relaxing ASMR Woman",
}

response = requests.post(f"{base_url}/tts", headers=headers, json=data)
response.raise_for_status()

result = response.json()
print(json.dumps(result, indent=2, ensure_ascii=False))

JaveScript

Response

{
  "audio": {
    "url": "https://cdn.aimlapi.com/generations/hippopotamus/1769604037348-b2b0235e-e813-462d-904e-632803a698b4.wav"
  },
  "meta": {
    "usage": {
      "credits_used": 12222
    }
  }
}

Listen to the audio sample we generated (~ 1.8 s):