APIs de audio

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 Models 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 desde la página de Models 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)

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

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 envoltura 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

Formato de audio no compatible

Usa los formatos documentados en la página del endpoint.

Carga grande rechazada

Comprime el archivo de audio o divide el trabajo en archivos más pequeños.

Transcripción vacía

Confirma que el archivo contiene voz y que el nombre del campo coincide con la documentación.

URL base incorrecta

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

Códigos de error y estrategia de reintento

400

No reintentes hasta que se corrijan el texto, archivo, model ID, voz o formato.

401

No reintentes hasta que la clave de API esté presente y sea válida.

404

Verifica la URL base, la ruta y el model ID antes de reintentar.

413

Reduce el tamaño de la carga antes de reintentar.

429

Reintenta con retroceso exponencial y reduce la concurrencia.

500 or 503

Reintenta con backoff para 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

Página de modelos

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

Directorio de modelos

Explora la disponibilidad y las capacidades de los modelos.

Precios

Consulta los precios antes de llamar a un modelo.

Moderación de contenido

Claves API

Elige una API de audio

Create speech

Create transcription

Create translation

Create speech

Ejemplo de respuesta

Registros de ejemplo de modelos

Errores comunes

Códigos de error y estrategia de reintento

Precios y directorio de modelos

Página de modelos

Directorio de modelos

Precios

​Elige una API de audio

Create speech

Create transcription

Create translation

​Create speech

​Ejemplo de respuesta

​Registros de ejemplo de modelos

​Errores comunes

​Códigos de error y estrategia de reintento

​Precios y directorio de modelos

Página de modelos

Directorio de modelos

Precios

Elige una API de audio

Create speech

Ejemplo de respuesta

Registros de ejemplo de modelos

Errores comunes

Códigos de error y estrategia de reintento

Precios y directorio de modelos