Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Use a documentação de modelos de áudio da CometAPI escolhendo se o seu app precisa de saída de fala, transcrição 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 da página Models ou do diretório de modelos antes de executar a requisição.
Abra Create Speech para usar o playground e o schema 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)

​
Exemplo de resposta

Uma resposta de fala bem-sucedida é áudio binário. A resposta HTTP pode ser assim: 
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 de /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

Use os formatos documentados na página do endpoint.
Comprima o arquivo de áudio ou divida o trabalho em arquivos menores.
Confirme que o arquivo contém fala e que o nome do campo corresponde ao da documentação.
Use https://api.cometapi.com/v1.

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

Não tente novamente até que o texto, arquivo, model ID, voz ou formato seja corrigido.
Não tente novamente até que a chave de API esteja presente e seja válida.
Verifique a base URL, o caminho e o model ID antes de tentar novamente.
Reduza o tamanho do upload antes de tentar novamente.
Tente novamente com exponential backoff e reduza a concorrência.
Tente novamente com backoff para erros transitórios do provedor ou do serviço.
Para padrões de implementação, veja Error codes and retry strategy e Rate limits and concurrency.

​
Preços e diretório de modelos

Models page

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

Model directory

Navegue pela disponibilidade e capacidades dos modelos.

Pricing

Verifique os preços antes de chamar um modelo.
Last modified on May 28, 2026