Audio API

Korzystaj z dokumentacji modeli audio CometAPI, wybierając, czy Twoja aplikacja potrzebuje generowania mowy, transkrypcji czy tłumaczenia. Endpointy audio używają tego samego wzorca klucza API CometAPI co inne endpointy zgodne z OpenAI.

Wybierz API audio

Create speech

Konwertuj tekst na mowę.

Create transcription

Transkrybuj audio do tekstu.

Create translation

Tłumacz audio na tekst w języku angielskim.

Create speech

Użyj model ID obsługującego audio ze strony Models lub z katalogu modeli. Poniższe przykłady wywołują endpoint mowy.

Te przykłady używają symbolu zastępczego your-audio-model-id. Zastąp go dostępnym model ID audio ze strony Models lub katalogu modeli przed uruchomieniem żądania.

Otwórz Create speech, aby skorzystać z playgroundu i schematu endpointu.

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

Przykład odpowiedzi

Pomyślna odpowiedź mowy to binarne audio. Odpowiedź HTTP może wyglądać tak:

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

speech.mp3

Przykładowe rekordy modeli

Ta przykładowa odpowiedź katalogu modeli pokazuje obwiednię /api/models oraz kształt jednego rekordu modelu audio. Nie jest to pełna lista modeli.

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

Typowe błędy

Nieobsługiwany format audio

Użyj formatów udokumentowanych na stronie endpointu.

Odrzucono duży upload

Skompresuj plik audio lub podziel zadanie na mniejsze pliki.

Pusta transkrypcja

Potwierdź, że plik zawiera mowę i że nazwa pola jest zgodna z dokumentacją.

Nieprawidłowy bazowy URL

Użyj https://api.cometapi.com/v1.

Kody błędów i strategia ponawiania

400

Nie ponawiaj, dopóki tekst, plik, model ID, voice lub format nie zostaną poprawione.

401

Nie ponawiaj, dopóki klucz API nie będzie obecny i prawidłowy.

404

Sprawdź bazowy URL, ścieżkę i model ID przed ponowieniem.

413

Zmniejsz rozmiar uploadu przed ponowieniem.

429

Ponawiaj z użyciem exponential backoff i zmniejsz współbieżność.

500 or 503

Ponawiaj z backoff w przypadku przejściowych błędów dostawcy lub usługi.

Wzorce implementacyjne znajdziesz w Kody błędów i strategia ponawiania oraz Rate limits and concurrency.

Cennik i katalog modeli

Strona modeli

Przeczytaj, jak CometAPI udostępnia model IDs w dokumentacji.

Katalog modeli

Przeglądaj dostępność modeli i ich możliwości.

Cennik

Sprawdź ceny przed wywołaniem modelu.

Moderacja treści

Klucze API

Wybierz API audio

Create speech

Create transcription

Create translation

Create speech

Przykład odpowiedzi

Przykładowe rekordy modeli

Typowe błędy

Kody błędów i strategia ponawiania

Cennik i katalog modeli

Strona modeli

Katalog modeli

Cennik

​Wybierz API audio

Create speech

Create transcription

Create translation

​Create speech

​Przykład odpowiedzi

​Przykładowe rekordy modeli

​Typowe błędy

​Kody błędów i strategia ponawiania

​Cennik i katalog modeli

Strona modeli

Katalog modeli

Cennik

Wybierz API audio

Create speech

Przykład odpowiedzi

Przykładowe rekordy modeli

Typowe błędy

Kody błędów i strategia ponawiania

Cennik i katalog modeli