API audio

Utilisez la documentation des modèles audio CometAPI en choisissant si votre application a besoin d’une sortie vocale, d’une transcription ou d’une traduction. Les endpoints audio utilisent le même modèle de clé API CometAPI que les autres endpoints compatibles OpenAI.

Choisir une API audio

Créer de la parole

Convertissez du texte en parole.

Créer une transcription

Transcrivez de l’audio en texte.

Créer une traduction

Traduisez de l’audio en texte anglais.

Create Speech

Utilisez un model ID compatible audio depuis la page Models ou le répertoire des modèles. Les exemples ci-dessous appellent l’endpoint de synthèse vocale.

Ces exemples utilisent l’espace réservé your-audio-model-id. Remplacez-le par un model ID audio disponible depuis la page Models ou le répertoire des modèles avant d’exécuter la requête.

Ouvrez Create speech pour utiliser le playground et le schéma de l’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

Exemple de réponse

Une réponse de synthèse vocale réussie est un audio binaire. La réponse HTTP peut ressembler à ceci :

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

speech.mp3

Exemples d’enregistrements de modèles

Cette réponse d’exemple du catalogue de modèles montre l’enveloppe /api/models et la forme d’un enregistrement de modèle audio. Il ne s’agit pas d’une liste complète de modèles.

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
      }
    }
  ]
}

Erreurs courantes

Format audio non pris en charge

Utilisez les formats documentés sur la page de l’endpoint.

Import volumineux rejeté

Compressez le fichier audio ou divisez la tâche en fichiers plus petits.

Transcription vide

Vérifiez que le fichier contient de la parole et que le nom du champ correspond à la documentation.

Mauvaise URL de base

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

Codes d’erreur et stratégie de nouvelle tentative

400

N’effectuez pas de nouvelle tentative tant que le texte, le fichier, le model ID, la voix ou le format n’est pas corrigé.

401

N’effectuez pas de nouvelle tentative tant que la clé API n’est pas présente et valide.

404

Vérifiez l’URL de base, le chemin et le model ID avant de réessayer.

413

Réduisez la taille de l’import avant de réessayer.

429

Réessayez avec un backoff exponentiel et réduisez la concurrence.

500 or 503

Réessayez avec un backoff pour les erreurs temporaires du fournisseur ou du service.

Pour les modèles d’implémentation, consultez Codes d’erreur et stratégie de nouvelle tentative et Limites de débit et concurrence.

Tarification et répertoire des modèles

Page des modèles

Découvrez comment CometAPI expose les model IDs dans la documentation.

Répertoire des modèles

Parcourez la disponibilité et les capacités des modèles.

Tarification

Vérifiez la tarification avant d’appeler un modèle.

Modération de contenu

Clés API

Choisir une API audio

Créer de la parole

Créer une transcription

Créer une traduction

Create Speech

Exemple de réponse

Exemples d’enregistrements de modèles

Erreurs courantes

Codes d’erreur et stratégie de nouvelle tentative

Tarification et répertoire des modèles

Page des modèles

Répertoire des modèles

Tarification

​Choisir une API audio

Créer de la parole

Créer une transcription

Créer une traduction

​Create Speech

​Exemple de réponse

​Exemples d’enregistrements de modèles

​Erreurs courantes

​Codes d’erreur et stratégie de nouvelle tentative

​Tarification et répertoire des modèles

Page des modèles

Répertoire des modèles

Tarification

Choisir une API audio

Create Speech

Exemple de réponse

Exemples d’enregistrements de modèles

Erreurs courantes

Codes d’erreur et stratégie de nouvelle tentative

Tarification et répertoire des modèles