OpenAI 互換 API キー:取得して呼び出し
OpenAI互換のAPIキーは、クライアントを異なるbase URLに設定すると、あらゆるOpenAI SDKで動作する通常のBearerトークンです。このページでは、当サイトのホスト済みテキストAPI用のキーの取得方法と、数分で動作する呼び出しを行う方法を示します。
更新済みSpeech To Text API

キーの実際の正体
「OpenAI 互換」は背後の企業ではなく HTTP API の形状を指します。このサービスは OpenAI SDK が送信する POST /v1/chat/completions に対して同じ JSON ボディを受け付け、同じ Authorization: Bearer ヘッダーを読み取ります。そのため、カスタムベース URL と API キーを設定できるツール(公式 Python および Node ライブラリ、LangChain、プレーンな curl、およびほとんどのデスクトップチャットクライアント)にキーをそのまま差し込めます。
このキーは OpenAI 用のキーではなく、api.openai.com では動作しません。その逆もまた真です:OpenAI のキーはここでは動作しません。各キーは 1 つのサービスに属しており、このサービスは単一のオープンウェイトモデルを実行しています。このモデルは成人による合法的な利用に対してコンテンツ拒否なしで回答するようにチューニングされており、独立したプロバイダによってホストされています。これはどのモデルベンダの公式 API ではなく、他のベンダへルーティングもされません。
覚えておくべき点はこれだけです。当サイトのベース URL は https://api.speechtotextapis.com/v1 です。モデル ID は uncensored です。キーはサインアップ後に取得する文字列です。以下はこれら 3 つの値のバリエーションです。
サービスはテキストのみです。チャット完了、ストリーミング、関数呼び出し、JSONモードを処理します。画像や音声の生成はなく、埋め込みやファインチューニングも提供しません。音声パイプラインから来た場合、典型的なタスクは文字起こし後のテキスト処理です:トランスクリプトのクリーンアップ、シーンへの分割、ダイアログの書き換え、または構造化データの抽出。音声スクリプト処理ガイドでその側面をより詳しく解説しています。
4つのステップでキーを取得
- サインアップ。 Googleを使用するか、メールアドレスとパスワードで登録します。
- APIキーページを開く。 当サイトのキーページにあります。キーはそこで生成され表示されます。
- トライアルクレジットを受け取る。 同じページのボタンでワンクリック、$0.50 のトライアルクレジットを受け取れます。1 人 1 回、7 日間有効、カード不要です。
- キーをシークレットストアにコピー。 ローカルテストには環境変数で十分です。デプロイする場合はホストのシークレットマネージャを使用してください。
トライアルは、何らかの支払いを行う前に統合が動作することを実証するために用意されています。現在の価格では、多くの短いリクエストに十分であり、以下のコストセクションで計算式を示しています。継続する準備ができたら、価格ページにチャージ金額が記載されています。クレジットは前払いで、サブスクリプションはなく、クレジットは期限切れにならないため、期限までにチャージ額を使い切る圧力はありません。
トライアルキーはフルキーより制限が厳しく、同時 2 リクエスト、1 分あたり 60 リクエストです。最初のスクリプトには十分です。トランスクリプトのチャンクを多数並列に処理する予定なら、資金提供済みアカウントに移行するまで制限に達する可能性があります。
すべてのクライアントが求める3つの設定
使用するソフトウェアにかかわらず、設定画面ではわずかに異なる名称で同じ3つの項目を求められます。
| 設定 | 一般的なフィールド名 | 内容 |
|---|---|---|
| エンドポイント | ベースURL、APIベース、ホスト | https://api.speechtotextapis.com/v1 |
| 資格情報 | APIキー、トークン、シークレット | キーページから取得したキー |
| モデル | モデル、モデル名、エンジン | uncensored |
1 つの注意点:ベース URL にはすでに /v1 が付いています。SDK は /chat/completions を自動で付加するため、追加する必要はありません。クライアントがベース URL ではなくチャットエンドポイントの完全な URL を求める場合、値は https://api.speechtotextapis.com/v1/chat/completions です。
ツールが「OpenAI」プリセットのみを提供し、ハードコードされたホストで編集できない場合、このサービスとは通信できません。「カスタム」、「OpenAI 互換」、または「詳細」オプションを探し、ベース URL フィールドを公開しているものを選択してください。
最初のリクエスト
curlから始めてください。これはあなたとAPIの間のすべてのレイヤーを取り除きます。YOUR_KEYをコピーしたキーに置き換えてください。
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
成功したレスポンスは choices 配列を持つ JSON オブジェクトです。テキストは choices[0].message.content にあり、usage ブロックは、課金対象となったトークンを報告します。
公式 Python ライブラリを使用した同じ呼び出しは次のようになります。base_url と api_key のみが標準的な OpenAI 設定と異なります。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
Node では同じパッケージを使用して次のようになります:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
max_tokens を設定する必要はありません。省略した場合、補完はプロンプト後の 100,000 トークンのウィンドウに残っている分を使用できます。呼び出しあたりのコストに上限を設定したい場合は自分で設定してください。
トークンを使わずにキーが動作するか確認
キーを大きなシステムに接続する前に、モデルエンドポイントに 1 回の安価な呼び出しを行います。これでキーが受け入れられ、ベース URL が正しいことが確認できます。
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
-i フラグはレスポンスヘッダーを出力します。この API はそこに有用な状態を報告します:
X-Request-Idはリクエストを識別します。特定の呼び出しについて サポート に連絡する場合は含めてください。X-Balance-USDは、アカウントの残高クレジットを表示します。X-RateLimit-Limit-RequestsとX-RateLimit-Limit-Concurrencyはキーに適用される制限を示し、キーがトライアルまたはフルの制限を持っているかを一目で判断できます。
独自コードでX-Balance-USDを読み取ることは、クレジットが尽きる前に自身に警告する手頃な方法です。ノイズの多い出力を避けたい場合は、リクエストごとではなく、ジョブごとに1回ログに記録してください。
キーの使用コスト
キーを持つこと自体にコストはありません。トークンに対して課金されます:入力トークン 100 万あたり $0.15、出力トークン 100 万あたり $0.50 は前払いクレジットから引かれます。失敗または拒否されたリクエストは課金されません。
上記のトランスクリプトクリーンアップ呼び出しの具体例。プロンプトが 1,000 トークン、クリーンな応答が 500 トークンであるとします。
- 入力:1,000 / 1,000,000 x $0.15 = $0.00015
- 出力:500 / 1,000,000 x $0.50 = $0.00025
- 合計:呼び出しあたり $0.0004
したがって $0.50 のトライアルクレジットでは、そのサイズの呼び出しが約 1,250 回賄えます($0.50 / $0.0004)。実際の数字は、トランスクリプトの長さが異なるため異なりますが、計算方法は同じです:入力トークンを数え、出力トークンを数え、掛け算します。
チャージする際、$20 から $500 の整数金額は受け取れます。より大きなチャージにはボーナスが付きます:$50 以上で +5%、$100 以上で +10%、$200 以上で +15%。例えば $100 のチャージでは、$110 のクレジットが得られます。暗号資産(TRC20 上の USDT、Base 上の USDC)でお支払いいただけます。
キーの安全な管理
API キーは残高のパスワードです。API キーを持っている人は誰でもクレジットを消費できるため、大切に扱ってください。
- ソース管理には含めないでください。環境変数またはシークレットマネージャーから読み取ってください。
- ブラウザのJavaScriptやモバイルアプリバンドルには含めないでください。ユーザーのデバイスで実行されるものはすべて検査可能です。フロントエンドとAPIの間に小さなサーバーを置き、サーバーがヘッダーを追加するようにしてください。
- スクリーンショット、チケット、チャットメッセージに貼り付けないでください。
- API キーが漏洩したと思われる場合は、何か起こるのを待つのではなく、すぐに使用を停止してサポートまでご連絡ください。
プライバシーについて:APIに送信されたプロンプトはトレーニングには使用されません。これはサービスに関する声明であり、送信する必要のない機密情報を送る理由にはなりません。タスクに必要でない場合は、トランスクリプトから個人データを削除してください。
呼び出しが失敗した場合
初日の問題のほとんどは、4つの原因のいずれかに起因します。
Base URLが間違っている
よくある2つのミスは、/v1 の欠落と、/chat/completions の二重化です。上記の表の値と文字単位で比較してください。
API キーに不要な文字が含まれている
ページからのコピーには、末尾のスペースや改行が含まれることがあります。コード内の値をトリムし、ヘッダーがBearer、半角スペース1つ、その後API キーとなっていることを確認してください。
モデル名がuncensoredではない
クライアントは他のモデル名をデフォルトに設定することがよくあります。すべての呼び出しでモデルを明示的に設定してください。
HTTP 429
2つの種類があり、エラーコードで区別できます。rate_limitedは、1分あたりのリクエスト数が多すぎたことを意味します。concurrencyは、同時に実行中のリクエストが多すぎたことを意味します。ストリーミングリクエストはストリーミングが終了するまで同時実行数の枠を保持するため、低速なリーダーは低いリクエスト率でもこのエラーを引き起こす可能性があります。Retry-After: 5 ヘッダー付きの429は、サービスが一時的に過負荷であることを意味します。5秒待ってから再試行してください。クライアントでの短い指数バックオフは、これら3つのケースすべてに対応できます。
パラメータ一覧、ストリーミング形式、ツール呼び出しの詳細については、APIドキュメントをご覧ください。
その他のガイド
質問と回答
これはOpenAIのAPI キーと同じですか?
いいえ。同じリクエスト形式に従っているためOpenAI SDKは動作しますが、これはこのサービスによって発行され、このサービスのBase URLに対してのみ機能します。
キーを取得するためにクレジットカードは必要ですか?
いいえ。Googleまたはメールアドレスでサインアップし、API キーページでワンクリックで$0.50 のトライアルクレジットを請求してください。トライアルにはカードが必要なく、7日間有効です。
どのモデル名を使用すべきですか?
モデルフィールドにuncensoredを使用してください。GET /v1/modelsへの呼び出しで、そのAPI キーでアクセスできるモデルの一覧が表示されます。
複数のサーバーで同じAPI キーを使用できますか?
はい、ただし制限はキー全体に適用されます:フルキーでは同時リクエスト 8 件、1 分あたり 300 件のリクエスト、トライアルキーでは 2 件および 60 件です。
そのAPI キーは画像や音声でも機能しますか?
いいえ。APIはテキストのみです。音声や画像の生成、トランスクリプト作成、埋め込み、ファインチューニングは行われません。