The OpenRouter API 説明
OpenAI互換APIを使用すると、ロジックを書き換えることなくコードベースを新しいプロバイダーに切り替えることができるため、特定のユースケースにアンセンサードモデルが必要な場合に重要です。このガイドでは、ベースURL、トークン価格、ストリーミングの仕組みを説明し、代替エンドポイントを確実に統合する方法を示します。
最終更新日
概要
- ベースURLを変更するだけで、任意のOpenAI SDKと標準的な/v1/chat/completionsエンドポイントを使用できます。
- トークン価格は前払いで透明性があり、月額サブスクリプションなしで実際の使用に対してのみ課金します。
- SSEによるストリーミングレスポンスは、チャットインターフェースにとって不可欠なリアルタイムのトークン配信を可能にします。
- 関数呼び出しとJSONモードは、構造化データの抽出とツール統合に使用できます。
OpenAI互換APIとは?
OpenAI のチャット完了インターフェースに準拠した REST API です。標準的な JSON ペイロードを使用してプロンプトを送信し、テキスト出力を受信します。この互換性により、既存のクライアントコードを大幅に変更することなく動作します。
主要エンドポイントは POST /v1/chat/completions です。これは、ロールとコンテンツのオブジェクトの配列としてメッセージを受け取ります。GET /v1/models を使用して利用可能なモデルを一覧表示することもできます。この標準化により、統合にかかる時間を大幅に短縮できます。
当社のサービスはまさにこのインターフェースを提供しています。当社は「uncensored」というIDの下で1つの無制限モデルを提供しています。これは当社の専用サーバー上で稼働しており、他のベンダーへルーティングしません。必要なモデルに直接アクセスできます。
コンテキストウィンドウは合計最大100,000トークンをサポートします。出力制限は1回あたり16,000トークンです。Server-Sent Eventsを介してストリーミングが可能です。関数呼び出しとJSONモードは完全にサポートされています。
ベースURLとAPIキーの理解
ベースURLはリクエストを処理するサーバーを指します。デフォルトの OpenAI URL を当社の専用エンドポイントに置き換えます。当社のベースURLは HTTPS://api.openrouterabliterated.com/v1 です。この変更により、トラフィックが無制限インフラストラクチャに送信されます。
APIキーはリクエストを認証します。アカウントごとに1つのキーを生成します。キーはサインアップ直後に表示されます。必要に応じて置き換えることができます。各アカウントは同時に1つのアクティブなキーのみ保持します。
レート制限はキーごとに適用されます。1分あたり300リクエストを送信できます。最大8つのリクエストを同時に実行できます。リクエストボディのサイズは8 MBに制限されます。これらの制限は、高ボリュームの使用に対応するのに十分です。
サインアップにはメールアドレスまたはGoogleアカウントのみが必要です。電話番号は不要です。キーは即座に表示されます。すぐにリクエストの送信を開始できます。プライバシーは保護され、プロンプトはトレーニングに使用されません。
なぜユースケースにアンセンサードモデルを選ぶのか?
Uncensoredモデルは合法的な大人向けコンテンツ、フィクション、または論争の的となるトピックを拒否しません。これらはクリエイティブライティング、ロールプレイ、または研究に最適です。主流のモデルは厳格なガードレールを適用することがよくあります。これらは生成のフローを中断する可能性があります。
当社のモデルは直接的に回答するようにチューニングされています。NSFWコンテンツを押し付けずに処理します。政治哲学やニッチなジャンルでよく機能します。余分なプロンプトなしで一貫した動作が得られます。
ツール使用がサポートされています。アプリケーション用のツールを定義できます。モデルはツール選択を尊重します。これにより複雑なワークフローに適しています。エラーと拒否は無料です。実際の使用分のみ課金されます。
コンテンツ制限はまだ適用されます。未成年を伴う性的コンテンツは常に拒否されます。これはハードリミットです。基本的な安全基準を保証します。それ以外はすべてあなたのユースケースの対象となります。
トークン価格: コストの計算方法
料金はトークン使用量に基づきます。入力トークンは100万トークンあたり$0.15です。出力トークンは100万トークンあたり$0.50です。使用した分のみ課金されます。隠れた手数料はありません。
クレジットは前払いです。暗号通貨のみでチャージします。TRC20上のUSDTまたはBase上のUSDCが受け付けられます。$20〜$500の任意の整数金額が許可されています。クレジットは期限切れしません。これにより、サブスクリプションのロックインを回避できます。
ボーナスクレジットはチャージ時に利用可能です。$50で+5%ボーナス、$100で+10%ボーナス、$200で+15%ボーナスが得られます。これにより実質コストが削減されます。エラーは無料、拒否も無料です。成功したトークンのみに対して課金されます。
トライアルアカウントには$0.50が付与されます。有効期限は7日間です。これによりAPIを徹底的にテストできます。資金を追加する前に統合を確認できます。
ストリーミングと非ストリーミングの応答
ストリーミングは生成されるトークンを送信します。これにより知覚されるレイテンシが低減します。ユーザーはテキストがリアルタイムで表示されるのを見ることができます。これはチャットインターフェースにとって不可欠です。非ストリーミングは完全なレスポンスを待ちます。長い出力では遅く感じられることがあります。
SSEによるストリーミングをサポートしています。最後のチャンクにはトークン使用量が含まれます。これにより、正確な請求追跡が可能です。部分的なレスポンスを適切に処理できます。エラーは一貫して処理されます。
ストリーミングなしも利用可能です。これは一度に完全なレスポンスを返します。バッチ処理にはこちらの方がシンプルです。ニーズに応じて選択してください。両方のモードは同じエンドポイントを使用します。
関数呼び出しはストリーミング可能です。ツールは識別されるたびに実行されます。これによりインタラクティブ性が向上します。入力の処理を早期に開始できます。APIが複雑な処理をすべて処理します。
関数呼び出しと構造化出力
関数呼び出しにより、モデルはツールを呼び出します。リクエスト内でツールスキーマを定義します。モデルは関数呼び出しを返します。あなたのコードがそれらを実行します。これにより複雑なワークフローが可能になります。エージェントやアシスタントを構築できます。
JSONモードは構造化出力を強制します。モデルは有効なJSONを返します。これはデータ抽出に役立ちます。一貫したフォーマットが得られます。解析が容易になります。エラーはめったに発生しません。
温度やtop_pなどのパラメータで動作を制御します。ストップシーケンスは出力を制限します。シードは再現性を保証します。ペナルティは反復を減らします。きめ細かい制御が可能です。
ツール選択は自動または強制に設定できます。モデルの優先度を指定します。これにより生成プロセスが誘導され、信頼性が向上します。アプリケーションは堅牢な状態を維持します。
一般的なクライアントライブラリとSDK
ほとんどの SDK はわずかな変更で動作します。base URL のみを更新すれば、残りのコードはそのままです。これは Python、Node.js など他の言語にも適用され、統合は簡単です。
OpenAI SDKは標準です。認証とリトライを処理します。APIキーを渡します。ベースURLは当社のサービスを指します。リクエストは通常通り送信されます。
ストリーミングはすべてのSDKでサポートされています。チャンクを反復処理します。トークン使用量は最終チャンクで利用可能です。これは当社の課金モデルに一致します。エラーは一貫してキャッチされます。
関数呼び出しは最新のSDKに組み込まれています。ツール定義を渡します。SDKはレスポンスを解析します。コードがツールを実行します。ループは完了するまで続行されます。これは効率的で信頼性が高いです。
一般的なAPIエラーのトラブルシューティング
レートリミットは429エラーを返します。1分あたり300リクエストを送信できます。これを超えると待機が必要です。指数関数的バックオフを実装してください。これにより、サーバーへの過負荷を防ぐことができます。
無効なキーは401エラーを返します。APIキーを確認してください。有効であることを確認し、必要に応じて置き換えてください。各アカウントには1つのキーがあります。紛失した場合は新しいキーを生成してください。
JSONモードではエラーが発生します。スキーマが有効であることを確認してください。モデルは有効なJSONを返す必要があります。失敗した場合は再試行してください。安定性を高めるために温度を調整してください。
タイムアウトは長い生成処理で発生します。タイムアウト値を増やしてください。ストリーミングはタイムアウトのリスクを減らします。部分的な応答も処理され、完全な出力を再構築できます。
次のステップ: 最初のAPIキーの取得
サインアップページにアクセスしてください。Googleまたはメールアドレスを使用してください。電話番号不要です。プロセスは高速です。すぐにアクセスできます。
APIキーが表示されます。安全にコピーしてください。SDKで使用してください。ベースURLを当社のエンドポイントに設定してください。リクエストの送信を開始します。
暗号通貨でチャージ。USDTまたはUSDCを受け付けています。高額チャージにはボーナスクレジットが付与されます。クレジットは失効しません。自分のペースで利用してください。
試用クレジットでテストしてください。有効期限は7日間です。ストリーミングと関数呼び出しを確認してください。モデルの機能を探索し、アプリに統合してください。APIは本番環境で利用可能です。
よくある質問
uncensoredモデルはOpenRouterのモデルと同じですか?
いいえ、当社のモデルは独立しています。当社の独自サーバーで稼働します。GPT、Claude、またはその他のベンダーのモデルではありません。フィルターなしの応答用にチューニングされています。ルーティングを経由せずに直接アクセスできます。
APIの支払い方法は?
暗号通貨のみ受付。TRC20のUSDTまたはBaseのUSDCに対応。チャージ額は$20〜$500。大口チャージでボーナスクレジット付与。クレジットは期限なし。
これはOpenAI SDKと併用できますか?
はい、完全に互換性があります。ベースURLを当社のエンドポイントに変更してください。認証方法はそのままご利用ください。コードの残りの部分は変更の必要ありません。ストリーミングと関数呼び出しは想定どおり動作します。
レート制限は何ですか?
1分間に300リクエストを送信できます。最大8つのリクエストを同時に実行できます。リクエストボディのサイズは8 MBに制限されます。これらの制限により、大量の使用にも対応できます。エラーと拒否は無料です。
APIキーを取得
サインアップしてキーをコピーし、ベースURLを更新するだけです。それだけです。