Audio API

Используйте документацию по аудиомоделям CometAPI, выбрав, требуется ли вашему приложению вывод речи, transcription или translation. Аудиоэндпоинты используют тот же шаблон API-ключа CometAPI, что и другие OpenAI-совместимые эндпоинты.

Выберите аудио API

Создание речи

Преобразование текста в речь.

Создание transcription

Преобразование аудио в текст.

Создание translation

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

Create speech

Используйте audio-совместимый model ID со страницы Models или из каталога моделей. В примерах ниже вызывается эндпоинт речи.

В этих примерах используется заполнитель your-audio-model-id. Перед выполнением запроса замените его на доступный audio model ID со страницы Models или из каталога моделей.

Откройте Create speech, чтобы использовать playground и схему эндпоинта.

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 ID в документации.

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

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

Цены

Проверьте цены перед вызовом модели.

Модерация контента

API-ключи

Выберите аудио API

Создание речи

Создание transcription

Создание translation

Create speech

Пример ответа

Примеры записей моделей

Распространённые ошибки

Коды ошибок и стратегия повторных попыток

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

Страница моделей

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

Цены

​Выберите аудио API

Создание речи

Создание transcription

Создание translation

​Create speech

​Пример ответа

​Примеры записей моделей

​Распространённые ошибки

​Коды ошибок и стратегия повторных попыток

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

Страница моделей

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

Цены

Выберите аудио API

Create speech

Пример ответа

Примеры записей моделей

Распространённые ошибки

Коды ошибок и стратегия повторных попыток

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