Saltar al contenido 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.

Usa la documentación de modelos de audio de CometAPI eligiendo si tu aplicación necesita salida de voz, transcripción o traducción. Los endpoints de audio usan el mismo patrón de clave API de CometAPI que otros endpoints compatibles con OpenAI.

​
Elige una API de audio

Create Speech

Convierte texto en voz.

Create Transcription

Transcribe audio a texto.

Create Translation

Traduce audio a texto en inglés.

​
Create Speech

Usa un model ID con capacidad de audio desde la página de modelos o el directorio de modelos. Los ejemplos a continuación llaman al endpoint de voz.
Estos ejemplos usan el marcador de posición your-audio-model-id. Sustitúyelo por un model ID de audio disponible de la página de modelos o el directorio de modelos antes de ejecutar la solicitud.
Abre Create Speech para usar el playground y el esquema del 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)

​
Ejemplo de respuesta

Una respuesta de voz correcta es audio binario. La respuesta HTTP puede verse así: 
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

​
Registros de ejemplo de modelos

Esta respuesta de ejemplo del catálogo de modelos muestra la estructura de /api/models y la forma de un registro de modelo de audio. No es una 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
      }
    }
  ]
}

​
Errores comunes

Usa los formatos documentados en la página del endpoint.
Comprime el archivo de audio o divide el trabajo en archivos más pequeños.
Confirma que el archivo contiene voz y que el nombre del campo coincide con la documentación.
Usa https://api.cometapi.com/v1.

​
Códigos de error y estrategia de reintento

No reintentes hasta que se corrijan el texto, el archivo, el model ID, la voz o el formato.
No reintentes hasta que la clave API esté presente y sea válida.
Verifica la URL base, la ruta y el model ID antes de reintentar.
Reduce el tamaño de la carga antes de reintentar.
Reintenta con backoff exponencial y reduce la concurrencia.
Reintenta con backoff ante errores transitorios del proveedor o del servicio.
Para patrones de implementación, consulta Error codes and retry strategy y Rate limits and concurrency.

​
Precios y directorio de modelos

Models page

Lee cómo CometAPI expone los model IDs en la documentación.

Model directory

Explora la disponibilidad y las capacidades de los modelos.

Pricing

Consulta los precios antes de llamar a un modelo.
Last modified on May 28, 2026