メインコンテンツへスキップ

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.

アプリに必要なのが音声出力、文字起こし、翻訳のどれかに応じて、CometAPI の音声モデルドキュメントを使い分けてください。音声エンドポイントは、他の OpenAI 互換エンドポイントと同じ CometAPI API キー形式を使用します。

​
音声 API を選択する

Create Speech

テキストを音声に変換します。

Create Transcription

音声をテキストに文字起こしします。

Create Translation

音声を英語テキストに翻訳します。

​
音声生成

Models page または model directory にある音声対応の model ID を使用します。以下の例では音声エンドポイントを呼び出します。
これらの例ではプレースホルダーとして your-audio-model-id を使用しています。リクエストを実行する前に、Models page または model directory で利用可能な音声 model ID に置き換えてください。
Create Speech を開くと、プレイグラウンドとエンドポイントスキーマを使用できます。
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)

​
レスポンス例

正常な音声レスポンスはバイナリ音声です。HTTP レスポンスは次のようになります。 
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

​
モデルレコードの例

この例のモデルカタログレスポンスは、/api/models のエンベロープと 1 つの音声モデルレコードの形状を示しています。完全なモデル一覧ではありません。
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
      }
    }
  ]
}

​
よくあるエラー

エンドポイントページに記載されている形式を使用してください。
音声ファイルを圧縮するか、ジョブをより小さなファイルに分割してください。
ファイルに音声が含まれていること、およびフィールド名がドキュメントと一致していることを確認してください。
https://api.cometapi.com/v1 を使用してください。

​
エラーコードと再試行戦略

テキスト、ファイル、model ID、voice、または format を修正するまで再試行しないでください。
API キーが存在し、有効になるまで再試行しないでください。
再試行する前に、ベース URL、パス、model ID を確認してください。
再試行する前に、アップロードサイズを小さくしてください。
指数バックオフで再試行し、同時実行数を減らしてください。
プロバイダーまたはサービスの一時的なエラーに対しては、バックオフ付きで再試行してください。
実装パターンについては、Error codes and retry strategy と Rate limits and concurrency を参照してください。

​
料金とモデルディレクトリ

Models page

CometAPI がドキュメント内で model ID をどのように公開しているかを確認してください。

Model directory

利用可能なモデルと機能を確認できます。

Pricing

モデルを呼び出す前に料金を確認してください。
Last modified on May 28, 2026