AiHubMix Documentation Hub

POST

audio

speech

Create Speech

curl --request POST \
  --url https://aihubmix.com/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": "<string>",
  "voice": "ash"
}
'

import requests

url = "https://aihubmix.com/v1/audio/speech"

payload = {
    "model": "<string>",
    "input": "<string>",
    "voice": "ash"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

"<string>"

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

Autorizações

Authorization

string

header

obrigatório

Gateway-issued API key, formatted as sk-gateway-xxxxxxxx. Used by OpenAI-shaped endpoints (/v1/chat/completions, etc.).

Corpo

application/json

model

obrigatório

One of the available TTS models: tts-1, tts-1-hd, gpt-4o-mini-tts, or gpt-4o-mini-tts-2025-12-15.

input

string

obrigatório

The text to generate audio for. The maximum length is 4096 characters.

Maximum string length: 4096

voice

obrigatório

The voice to use when generating the audio. Supported built-in voices are alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse, marin, and cedar. You may also provide a custom voice object with an id, for example { "id": "voice_1234" }. Previews of the voices are available in the Text to speech guide.

Exemplo:

"ash"

instructions

string

Control the voice of your generated audio with additional instructions. Does not work with tts-1 or tts-1-hd.

Maximum string length: 4096

response_format

enum<string>

padrão:mp3

The format to audio in. Supported formats are mp3, opus, aac, flac, wav, and pcm.

Opções disponíveis:

mp3,

opus,

aac,

flac,

wav,

pcm

speed

number

padrão:1

The speed of the generated audio. Select a value from 0.25 to 4.0. 1.0 is the default.

Intervalo necessário: 0.25 <= x <= 4

stream_format

enum<string>

padrão:audio

The format to stream the audio in. Supported formats are sse and audio. sse is not supported for tts-1 or tts-1-hd.

Opções disponíveis:

sse,

audio

Resposta

The response is of type file.

Create TranscriptionTranscribes audio into the input language. Returns a transcription object in `json`, `diarized_json`, or `verbose_json` format, or a stream of transcript events.

Create Speech

curl --request POST \
  --url https://aihubmix.com/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": "<string>",
  "voice": "ash"
}
'

import requests

url = "https://aihubmix.com/v1/audio/speech"

payload = {
    "model": "<string>",
    "input": "<string>",
    "voice": "ash"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

"<string>"

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<unknown>"
  }
}

Endpoints de modelo

API de plataforma

Create Speech

Autorizações

Corpo

Resposta