Zum Hauptinhalt springen

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.

Verwenden Sie die Audio-Modell-Dokumentation von CometAPI, indem Sie auswählen, ob Ihre App Sprachausgabe, Transkription oder Übersetzung benötigt. Audio-Endpunkte verwenden das gleiche CometAPI API-Schlüssel-Muster wie andere OpenAI-kompatible Endpunkte.

Einen Audio-API auswählen

Create Speech

Text in Sprache umwandeln.

Create Transcription

Audio in Text transkribieren.

Create Translation

Audio in englischen Text übersetzen.

Speech erstellen

Verwenden Sie eine model ID mit Audio-Unterstützung von der Models page oder dem model directory. Die folgenden Beispiele rufen den Speech-Endpunkt auf.
Diese Beispiele verwenden den Platzhalter your-audio-model-id. Ersetzen Sie ihn durch eine verfügbare Audio model ID von der Models page oder dem model directory, bevor Sie die Anfrage ausführen.
Öffnen Sie Create Speech, um den Playground und das Endpunkt-Schema zu verwenden.
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)

Antwortbeispiel

Eine erfolgreiche Speech-Antwort ist binäres Audio. Die HTTP-Antwort kann so aussehen:
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

Beispiel-Modell-Datensätze

Diese Beispielantwort des Modellkatalogs zeigt den /api/models-Envelope und die Struktur eines einzelnen Audio-Modell-Datensatzes. Es ist keine vollständige Modellliste.
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
      }
    }
  ]
}

Häufige Fehler

Verwenden Sie die Formate, die auf der Endpunktseite dokumentiert sind.
Komprimieren Sie die Audiodatei oder teilen Sie den Auftrag in kleinere Dateien auf.
Bestätigen Sie, dass die Datei Sprache enthält und dass der Feldname mit der Dokumentation übereinstimmt.
Verwenden Sie https://api.cometapi.com/v1.

Fehlercodes und Retry-Strategie

Versuchen Sie es erst erneut, wenn Text, Datei, model ID, voice oder Format korrigiert wurden.
Versuchen Sie es erst erneut, wenn der API-Schlüssel vorhanden und gültig ist.
Prüfen Sie Base URL, Pfad und model ID, bevor Sie es erneut versuchen.
Verringern Sie die Upload-Größe, bevor Sie es erneut versuchen.
Versuchen Sie es mit exponentiellem Backoff erneut und reduzieren Sie die Parallelität.
Versuchen Sie es bei vorübergehenden Anbieter- oder Dienstfehlern mit Backoff erneut.
Implementierungsmuster finden Sie unter Error codes and retry strategy und Rate limits and concurrency.

Preise und Model-Verzeichnis

Models page

Lesen Sie, wie CometAPI model IDs in der Dokumentation bereitstellt.

Model directory

Durchsuchen Sie die Verfügbarkeit und Fähigkeiten der Modelle.

Pricing

Prüfen Sie die Preise, bevor Sie ein Modell aufrufen.
Last modified on May 28, 2026