Audio-API's

Gebruik de documentatie van CometAPI-audiomodellen door te bepalen of je app spraakuitvoer, transcriptie of vertaling nodig heeft. Audio-endpoints gebruiken hetzelfde CometAPI API-sleutelpatroon als andere OpenAI-compatibele endpoints.

Kies een audio-API

Create speech

Zet tekst om naar spraak.

Create transcription

Transcribeer audio naar tekst.

Create translation

Vertaal audio naar Engelse tekst.

Create speech

Gebruik een audio-geschikte model ID van de Models page of de model directory. De onderstaande voorbeelden roepen het speech-endpoint aan.

Deze voorbeelden gebruiken de placeholder your-audio-model-id. Vervang deze door een beschikbare audio model ID van de Models page of model directory voordat je het verzoek uitvoert.

Open Create speech om de playground en het endpointschema te gebruiken.

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

Responsvoorbeeld

Een succesvolle speech-respons is binaire audio. De HTTP-respons kan er als volgt uitzien:

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

speech.mp3

Voorbeeld-modelrecords

Deze voorbeeldrespons van de modelcatalogus toont de /api/models-envelop en de vorm van één audio-modelrecord. Dit is geen volledige modellijst.

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

Veelvoorkomende fouten

Niet-ondersteund audioformaat

Gebruik de formaten die op de endpointpagina zijn gedocumenteerd.

Grote upload afgewezen

Comprimeer het audiobestand of splits de taak op in kleinere bestanden.

Lege transcriptie

Controleer of het bestand spraak bevat en of de veldnaam overeenkomt met de documentatie.

Verkeerde basis-URL

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

Foutcodes en retry-strategie

400

Probeer niet opnieuw totdat de tekst, het bestand, model ID, de stem of het formaat is gecorrigeerd.

401

Probeer niet opnieuw totdat de API-sleutel aanwezig en geldig is.

404

Controleer de basis-URL, het pad en model ID voordat je het opnieuw probeert.

413

Verklein de uploadgrootte voordat je het opnieuw probeert.

429

Probeer opnieuw met exponentiële backoff en verlaag de gelijktijdigheid.

500 or 503

Probeer opnieuw met backoff bij tijdelijke provider- of servicefouten.

Zie voor implementatiepatronen Foutcodes en retry-strategie en Rate limits and concurrency.

Prijzen en modeloverzicht

Modellenpagina

Lees hoe CometAPI model IDs in de documentatie weergeeft.

Modeloverzicht

Bekijk de beschikbaarheid en mogelijkheden van modellen.

Prijzen

Controleer de prijzen voordat je een model aanroept.

Contentmoderatie

API-sleutels

Kies een audio-API

Create speech

Create transcription

Create translation

Create speech

Responsvoorbeeld

Voorbeeld-modelrecords

Veelvoorkomende fouten

Foutcodes en retry-strategie

Prijzen en modeloverzicht

Modellenpagina

Modeloverzicht

Prijzen

​Kies een audio-API

Create speech

Create transcription

Create translation

​Create speech

​Responsvoorbeeld

​Voorbeeld-modelrecords

​Veelvoorkomende fouten

​Foutcodes en retry-strategie

​Prijzen en modeloverzicht

Modellenpagina

Modeloverzicht

Prijzen

Kies een audio-API

Create speech

Responsvoorbeeld

Voorbeeld-modelrecords

Veelvoorkomende fouten

Foutcodes en retry-strategie

Prijzen en modeloverzicht