aisplice

Referência da API

Áudio

Nenhum modelo atende a isto ainda

Nenhum modelo do catálogo oferece esta rota no momento. A página continua disponível como referência.
POST/v1/audio/speech
POST/v1/audio/transcriptions
POST/v1/audio/translations

Fala nos dois sentidos: /v1/audio/speech sintetiza texto em bytes de áudio; /v1/audio/transcriptions transforma áudio em texto (compatível com Whisper); /v1/audio/translations transcreve direto para inglês.

#Parâmetros da requisição

  • modelstringobrigatório

    Classe tts-1 para fala; classe whisper-1 para transcrição.

  • inputstringobrigatório

    Somente speech: o texto a ser falado.

  • voicestringobrigatório

    Somente speech: nome da voz (alloy, nova, …); vozes disponíveis na ficha do modelo.

  • filefile (multipart)obrigatório

    Somente transcriptions: o arquivo de áudio (mp3, wav, m4a, webm …).

  • languagestringopcional

    Somente transcriptions: indicação ISO-639-1 que melhora a precisão.

  • response_formatstringopcional

    speech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.

  • speednumberopcional

    Somente speech: velocidade de reprodução de 0,25 a 4,0.

Dois tipos de conteúdo diferentes

speech recebe um corpo JSON e retorna bytes de áudio brutos; transcriptions/translations recebem multipart/form-data e retornam JSON. Não misture os dois.

#Erros relacionados

  • 413 payload_too_largeO corpo da requisição (prompt, imagem ou arquivo de áudio) excede o tamanho aceito.
  • 401Bearer token inválido ou ausente. Não há error.code neste caminho — verifique o status.
  • 402 insufficient_user_quotaO saldo da carteira não cobre a estimativa pré-reservada.
  • 429Limitação por chave. Corpo vazio; aguarde o Retry-After. Um 429 que traz insufficient_user_quota indica, na verdade, o limite de gastos diário.
  • 503 model_not_foundModelo desconhecido, ou nenhum canal saudável o atende no momento.

Tabela completa de códigos de erro →

#Exemplo de requisição

# text → speech (bytes saved to file)
curl https://www.aisplice.store/v1/audio/speech \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "tts-1", "voice": "alloy", "input": "Hello from the gateway."}' \
  --output hello.mp3

# speech → text (multipart)
curl https://www.aisplice.store/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -F file=@meeting.mp3 -F model=whisper-1

#Resposta

response.json
// /v1/audio/speech → binary audio body (Content-Type: audio/mpeg)

// /v1/audio/transcriptions
{"text": "…transcript…"}

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.

AnteriorModelos 3DPróximoPolítica de upload de arquivos