APIs de áudio

Use a documentação de modelos de áudio da CometAPI escolhendo se o seu app precisa de saída de fala, transcription ou tradução. Os endpoints de áudio usam o mesmo padrão de chave de API da CometAPI que outros endpoints compatíveis com OpenAI.

Escolha uma API de áudio

Create speech

Converta texto em fala.

Create transcription

Transcreva áudio em texto.

Create translation

Traduza áudio para texto em inglês.

Create speech

Use um model ID com capacidade de áudio da página Models ou do diretório de modelos. Os exemplos abaixo chamam o endpoint de fala.

Estes exemplos usam o placeholder your-audio-model-id. Substitua-o por um model ID de áudio disponível na página Models ou no diretório de modelos antes de executar a solicitação.

Abra Create speech para usar o playground e o esquema do endpoint.

import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/audio/speech",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-audio-model-id",
        "input": "Welcome to CometAPI.",
        "voice": "alloy",
        "response_format": "mp3",
    },
    timeout=60,
)

response.raise_for_status()

with open("speech.mp3", "wb") as audio_file:
    audio_file.write(response.content)

import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.cometapi.com/v1/audio/speech", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-audio-model-id",
    input: "Welcome to CometAPI.",
    voice: "alloy",
    response_format: "mp3",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const audio = Buffer.from(await response.arrayBuffer());
await writeFile("speech.mp3", audio);

curl https://api.cometapi.com/v1/audio/speech \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-audio-model-id",
    "input": "Welcome to CometAPI.",
    "voice": "alloy",
    "response_format": "mp3"
  }' \
  --output speech.mp3

Exemplo de resposta

Uma resposta de fala bem-sucedida é áudio binário. A resposta HTTP pode ter esta aparência:

HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

Registros de modelo de exemplo

Esta resposta de exemplo do catálogo de modelos mostra o envelope /api/models e o formato de um registro de modelo de áudio. Não é uma lista completa de modelos.

cURL

curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 0,
      "id": "your-audio-model-id",
      "code": "your-audio-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example audio model",
      "model_type": "audio",
      "features": [
        "text-to-speech"
      ],
      "endpoints": [
        "openai"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 12,
        "output": 12,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

Erros comuns

Formato de áudio não suportado

Use os formatos documentados na página do endpoint.

Upload grande rejeitado

Comprima o ficheiro de áudio ou divida a tarefa em ficheiros menores.

Transcrição vazia

Confirme que o ficheiro contém fala e que o nome do campo corresponde ao indicado na documentação.

URL base incorreta

Use https://api.cometapi.com/v1.

Códigos de erro e estratégia de retry

400

Não tente novamente até que o texto, ficheiro, model ID, voz ou formato seja corrigido.

401

Não tente novamente até que a chave de API esteja presente e seja válida.

404

Verifique a URL base, o caminho e o model ID antes de tentar novamente.

413

Reduza o tamanho do upload antes de tentar novamente.

429

Tente novamente com exponential backoff e reduza a concorrência.

500 or 503

Tente novamente com backoff para erros transitórios do fornecedor ou do serviço.

Para padrões de implementação, consulte Códigos de erro e estratégia de retry e Limites de taxa e concorrência.

Preços e diretório de modelos

Página de modelos

Leia como a CometAPI expõe model IDs na documentação.

Diretório de modelos

Explore a disponibilidade e as capacidades dos modelos.

Preços

Verifique os preços antes de chamar um modelo.

Moderação de conteúdo

Chaves de API

Escolha uma API de áudio

Create speech

Create transcription

Create translation

Create speech

Exemplo de resposta

Registros de modelo de exemplo

Erros comuns

Códigos de erro e estratégia de retry

Preços e diretório de modelos

Página de modelos

Diretório de modelos

Preços

​Escolha uma API de áudio

Create speech

Create transcription

Create translation

​Create speech

​Exemplo de resposta

​Registros de modelo de exemplo

​Erros comuns

​Códigos de erro e estratégia de retry

​Preços e diretório de modelos

Página de modelos

Diretório de modelos

Preços

Escolha uma API de áudio

Create speech

Exemplo de resposta

Registros de modelo de exemplo

Erros comuns

Códigos de erro e estratégia de retry

Preços e diretório de modelos