Audio API

Використовуйте документацію аудіомоделей CometAPI, обравши, чи вашому застосунку потрібен вивід мовлення, транскрибування або переклад. Аудіоендпоінти використовують той самий шаблон API key CometAPI, що й інші OpenAI-сумісні ендпоінти.

Виберіть audio API

Create speech

Перетворюйте текст на мовлення.

Create transcription

Транскрибуйте аудіо в текст.

Create translation

Перекладайте аудіо в англійський текст.

Create speech

Використовуйте audio-capable model ID зі сторінки Models або каталогу моделей. Наведені нижче приклади викликають speech endpoint.

У цих прикладах використовується заповнювач your-audio-model-id. Замініть його на доступний audio model ID зі сторінки Models або каталогу моделей перед виконанням запиту.

Відкрийте Create speech, щоб скористатися playground і схемою 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

Приклад відповіді

Успішна відповідь speech — це двійкове аудіо. HTTP-відповідь може виглядати так:

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

speech.mp3

Приклади записів моделей

Цей приклад відповіді каталогу моделей показує оболонку /api/models і форму одного запису аудіомоделі. Це не повний список моделей.

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

Поширені помилки

Непідтримуваний формат аудіо

Використовуйте формати, задокументовані на сторінці endpoint.

Відхилено велике завантаження

Стисніть аудіофайл або розбийте завдання на менші файли.

Порожня транскрипція

Переконайтеся, що файл містить мовлення і що назва поля відповідає документації.

Неправильний base URL

Використовуйте https://api.cometapi.com/v1.

Коди помилок і стратегія повторних спроб

400

Не повторюйте запит, доки не буде виправлено text, file, model ID, voice або format.

401

Не повторюйте запит, доки API key не буде присутнім і дійсним.

404

Перевірте base URL, path і model ID перед повторною спробою.

413

Зменште розмір завантаження перед повторною спробою.

429

Повторюйте запит з exponential backoff і зменште concurrency.

500 or 503

Повторюйте запит з backoff для тимчасових помилок провайдера або сервісу.

Щоб ознайомитися з шаблонами реалізації, дивіться Коди помилок і стратегія повторних спроб і Ліміти запитів і concurrency.

Ціни та каталог моделей

Сторінка моделей

Дізнайтеся, як CometAPI показує model IDs у документації.

Каталог моделей

Перегляньте доступність і можливості моделей.

Ціни

Перевірте ціни перед викликом моделі.

Модерація контенту

API-ключі

Виберіть audio API

Create speech

Create transcription

Create translation

Create speech

Приклад відповіді

Приклади записів моделей

Поширені помилки

Коди помилок і стратегія повторних спроб

Ціни та каталог моделей

Сторінка моделей

Каталог моделей

Ціни

​Виберіть audio API

Create speech

Create transcription

Create translation

​Create speech

​Приклад відповіді

​Приклади записів моделей

​Поширені помилки

​Коди помилок і стратегія повторних спроб

​Ціни та каталог моделей

Сторінка моделей

Каталог моделей

Ціни

Виберіть audio API

Create speech

Приклад відповіді

Приклади записів моделей

Поширені помилки

Коди помилок і стратегія повторних спроб

Ціни та каталог моделей