Saltar para o conteúdo principal
POST
/
audio
/
speech
Gera fala
curl --request POST \
  --url https://api.orcarouter.ai/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "openai/tts-1",
  "input": "<string>",
  "voice": "<string>",
  "instructions": "<string>",
  "speed": 2.125,
  "stream_format": "<string>",
  "response_format": "mp3"
}
'

Autorizações

​
Authorization
string
header
obrigatório

As chaves de API do OrcaRouter têm o formato sk-orca-.... Passe-as no cabeçalho Authorization: Bearer sk-orca-....

Corpo

application/json
​
model
string
obrigatório

Modelo TTS da OpenAI — openai/tts-1, openai/tts-1-hd, openai/gpt-4o-mini-tts. Modelos preview de TTS do Gemini não são servidos neste endpoint; use a superfície nativa /v1beta/ do Gemini com responseModalities: ["AUDIO"] em vez disso.

Exemplo:

"openai/tts-1"

​
input
string
obrigatório
​
voice
string
obrigatório

Identificador de voz. O gateway encaminha este campo para o upstream inalterado — use o nome de voz que o modelo upstream suportar.

Exemplos:

"alloy"

"echo"

"fable"

"onyx"

"nova"

"shimmer"

​
instructions
string

Direção de voz opcional (ex. estilo, tom). Honrada por modelos que a suportam, como openai/gpt-4o-mini-tts.

​
speed
number

Taxa de reprodução. Padrão 1.0.

Intervalo necessário: 0.25 <= x <= 4
​
stream_format
string

Quando definido, a resposta é transmitida neste formato chunk-por-chunk (sujeito ao suporte upstream).

​
response_format
enum<string>
padrão:mp3
Opções disponíveis:
mp3,
opus,
aac,
flac,
wav,
pcm

Resposta

Conteúdo de áudio binário.