OpenAI API代替:コードの変更点
多くのOpenAI API代替はOpenAIのリクエスト形式をコピーしているため、切替は多くの場合書き換えではなく設定変更で済みます。この記事では、コード上の変更点、破綻しうる点、および単一モデルのOpenAI互換エンドポイントが適する場所とそうでない場所を詳しく示します。


代替が提供できるもの
人々は価格、コンテンツルール、データ処理、地域の利用可能性、またはオープンウェイトモデルの使用を望むという理由でOpenAI API代替を探しています。理由が何であれ、同じテストが適用されます。代替はすでに送信しているリクエスト形状を受け入れ、すでに解析しているレスポンス形状を返すでしょうか?
はいの場合、SDK呼び出しは変更されません。いいえの場合、アダプタを1回記述する必要がありますが、それでも問題ありません。ただし、切替の主なコストとなります。この記事の残りは、最初のケース、つまりOpenAI互換エンドポイントを前提としています。
3行の変更
公式のPythonパッケージでは、元のセットアップにはデフォルトのホストとOpenAIキーがあります。代替の場合、次の3つを設定します:base_url、新しいプロバイダからのキー、およびモデル名です。このエンドポイントの完成版は次の通りです:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaimodels.com/v1", # was the default host
api_key=os.environ["NEW_PROVIDER_KEY"], # was your OpenAI key
)
r = client.chat.completions.create(
model="uncensored", # was an OpenAI model name
messages=[{"role": "user", "content": "Pitch me a plot twist for a mystery."}],
)
print(r.choices[0].message.content)
NodeではコンストラクタにbaseURLを渡すことで同じことが実現できます。LangChainスタイルのラッパーではベースURLオプション経由、カスタムエンドポイントフィールドを持つツールでも同様です。curlではホストとヘッダーを変更します:
curl https://api.uncensoredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $NEW_PROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'切替後に破綻する可能性のあるもの
モデル名
モデルIDはプロバイダに属します。OpenAIのモデル名をハードコードしているものはすべて更新が必要です。名前は設定に格納してください。
パラメータ
temperature、top_p、stop、max_tokensなどのコアオプションは引き継がれます。logprobsや特定のresponse_formatオプションなど、他のオプションはプロバイダに依存します。このエンドポイントでは、temperature、top_p、stop、seed、ペナルティがそのまま転送され、JSONモードはresponse_format: {"type":"json_object"}で動作します。
ツール呼び出しの品質
ワイヤーフォーマットは共有されていますが、モデルがツールを選択し引数を埋める方法は異なります。実際のツールスキーマを新しいモデルで実行し、コード内で引数を検証してください。
コンテキストの長さと切り捨て
コンテキストウィンドウを変更すると、送信できる履歴の量が変わります。ここでは、プロンプトと完了の合計で100,000トークンのウィンドウです。
エラーと制限
プロバイダーは異なる制限とコードを使用します。このプロバイダーは、1分あたりのリクエスト数に対してrate_limited、同時実行に対してはconcurrencyを返すHTTP 429を返し、一時的な過負荷時にはRetry-After: 5付きの429を返します。リトライロジックは、すべてのプロバイダーの429を処理する必要があります。
動作
最大の変更は技術的なものではありません。モデルはトーン、フォーマット習慣、拒否する内容が異なります。デモではなく、実際のプロンプトでテストしてください。
単一モデルエンドポイントが適する場所
このサービスは、独立したプロバイダによって実行され、法的な成人向け利用においてコンテンツ拒否なしで回答するように調整された、単一のオープンウェイトモデルを持つOpenAI互換テキストAPIです。OpenAI、Meta、Mistral、Qwen、DeepSeek、xAI、Google、Anthropic、または他のいかなるベンダーの公式APIではなく、ベンダー間のルーターでもありません。モデルIDはuncensoredです。
これはこれらの用途に適合します:成人向けのフィクションおよびロールプレイツール、コンパニオンアプリ、シーン途中で中断しないべき執筆アシスタント、および複数のモデル間で選択するよりも成熟したテーマでの安定した動作が重要であるバックエンド。また、シンプルなトークン単価と、トレーニングに使用されないプロンプトを希望する開発者にも適しています。
適合しないケース
トラフィックを移行する前に制限について正直になりましょう:
- 単一モデルのみ。簡単なタスクには小さく安価なモデル、難しいタスクには大きなモデルを選択できません。モデルルーティングに依存している場合、異なるプラットフォームが必要です。
- テキストのみ。画像、オーディオ、ビデオ生成、埋め込み、ファインチューニングはありません。埋め込みが必要な検索アプリは、それらを別所で取得する必要があります。
- ベンダーのフラッグシップではありません。コンプライアンスやベンチマークのために特定のモデル名が必要な場合は、そのベンダーを使用してください。
- ハードリミット。未成年者を含む性的なコンテンツは、常に禁止です。
多くのチームは2つのエンドポイントを実行しています。1つはメインのプロバイダー用、もう1つは最初のプロバイダーが拒否するコンテンツ用です。両方が同じ形式を共有するため、これは少量のコード、設定の切り替え、特定のエラー時のフォールバックで済みます。
コスト:比較方法
各プロバイダーの現在の価格を確認し、リクエストの形式に変換してください。このエンドポイントでは、入力は1Mトークンあたり$0.15、出力は1Mトークンあたり$0.50です。例:3,000トークンの入力と500トークンの出力の場合、1回あたりのコストは$0.00045 + $0.00025 = $0.0007となり、月10,000回の呼び出しで$7になります。失敗または拒否されたリクエストには課金されず、サブスクリプションはなく、クレジットは期限切れになりません。
チャージは$20から$500の範囲で、暗号資産(TRC20上のUSDT、Base上のUSDC)で可能で、$50以上は+5%、$100以上は+10%、$200以上は+15%のボーナスが付きます。異なるモデルの比較については、AIモデルと価格の比較をご覧ください。価格ページに完全なリストがあります。
2つのエンドポイントに対するフォールバックパターン
メインプロバイダが拒否するコンテンツ用の2番目のエンドポイントが必要な場合、両方のクライアントを保持し、リクエストごとに選択します。このコード例は、まずメインプロバイダにリクエストを送信し、定義した拒否マーカーがある場合、または呼び出しが失敗した場合に2番目のエンドポイントを試みます:
import os
from openai import OpenAI
main = OpenAI(api_key=os.environ["MAIN_KEY"])
second = OpenAI(
base_url="https://api.uncensoredaimodels.com/v1",
api_key=os.environ["NEW_PROVIDER_KEY"],
)
def ask(messages, main_model, use_second_first=False):
order = [(second, "uncensored"), (main, main_model)] if use_second_first else [(main, main_model), (second, "uncensored")]
last = None
for client, model in order:
try:
r = client.chat.completions.create(model=model, messages=messages)
return r.choices[0].message.content
except Exception as err:
last = err
raise last
可能な場合はコンテンツタイプでルーティングしてください。ストーリー作成機能はuse_second_first=Trueで2番目のエンドポイントに直接送信でき、請求アシスタントはメインのものに留まります。これにより、失敗した呼び出しの代金を先に支払うことを避け、ユーザーにとっての動作を予測可能に保ちます。
安全なテスト方法
すべてのトラフィックを一度に移行しないでください。APIキーページで$0.50の無料トライアルクレジットを受け取りましょう。カードは不要で、7日間有効です。その後、以下の手順を実行してください。
- ログからの実際のプロンプト20個を新しいエンドポイントでリプレイします。
- 現在のプロバイダと比較して、回答、トークン数、失敗を確認します。
- 429を強制し、リトライが機能することを確認します。
- 機能フラグを通じて生産トラフィックの5%を送信します。
- トラフィックの拡大を行う前に、
X-Balance-USDヘッダーとエラー率を数日間監視してください。
ドキュメントはメソッドをカバーしており、無検閲コーディングLLMは1人の開発者の使用例を詳細に示しています。
その他のガイド
質問と回答
OpenAI SDKを他のプロバイダで使えますか?
はい、プロバイダーがOpenAI互換であれば可能です。ベースURL、API キー、モデル名を新しいプロバイダーの値に設定してください。
このサービスはOpenAIのAPIですか?
いいえ。これは独立したOpenAI互換のエンドポイントで、オープンウェイトモデルを1つ実行しており、OpenAIやその他のベンダーの公式APIではありません。
ストリーミングとツールはサポートされていますか?
はい。ストリーミングはstream: trueによるSSEで動作し、ツール呼び出しは標準的なtoolsおよびtool_calls形式を使用します。
切り替える前に確認すべきことは何ですか?
モデル名、サポートされているパラメータ、関数呼び出しの動作、コンテキストウィンドウの制限、429エラーの処理、そして何より、実際のプロンプトに対するモデルの回答方法です。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。