OpenAI互換APIエンドポイント:サポート内容
このサービスがサポートするOpenAI互換APIエンドポイントのリスト、各エンドポイントの動作するリクエスト、および欠けている機能の明確なリスト。
主要ポイント
- 5つのパス:チャット補完、レスポンス、モデル、および2つの残高ルート。
- モデルIDは uncensored で、1つのキーで任意のOpenAI SDKで使用できます。
- 画像、音声、動画、埋め込み、ファインチューニングはありません。
- 制限に達するとHTTP 429が返され、明確なエラーコードが表示されます。

エンドポイントの概要
プロバイダーはOpenAI互換のパスを本当にどれくらい実装しているのでしょうか? 以下にこのAPIの簡易リストを示します。基本URL: https://api.uncensoredendpoint.com/v1。認証はすべての呼び出しでBearerキーを使用します。
| メソッドとパス | 目的 |
|---|---|
POST /v1/chat/completions | チャットリクエスト、ストリーミング、ツール、JSONモード |
POST /v1/responses | 新しい Responses スタイルのリクエスト形式 |
GET /v1/models | モデルをリスト表示します。IDは uncensored です。 |
GET /v1/dashboard/billing/credit_grants | OpenAI風の形式での残高 |
GET /v1/balance | シンプルな形式での残高 |
これが API の全範囲です。表に含まれていない機能は提供されません。コードを書く前に計画を立てられるよう、動作するリクエストと欠けている機能のリストについて、以下をお読みください。
チャット補完
これはクライアントが最も使用するエンドポイントです。Base URLに任意のOpenAI SDKを指し、モデル名 uncensored を使用してください。
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)サポートされているパラメータには stream、tools、tool_choice、response_format(json_object)およびサンプリングパラメータの集合(temperature、top_p、stop、seed)とペナルティが含まれます。max_tokensはオプションです。100,000 トークンのコンテキストウィンドウの残りを補完が使用するためです。
stream: true を使用すると、返信はサーバー送信イベントとして届き、末尾に使用量が含まれるため、トークン数をログに記録できます。
マルチターンチャット
APIは会話の状態を保持しません。マルチターンチャットでは、毎回メッセージリスト全体を送信します。最初にシステムメッセージを配置し、その後ユーザーとアシスタントの会話を交互に記述します。これにより、ターンが進むごとに入力トークン数が増加し、コストも増大するため、会話が長くなったら古いターンを切り捨てたり要約したりしてください。プロンプトと補完を合わせたウィンドウは10万トークンで、ほとんどのチャットには十分ですが、貼り付けたドキュメントですぐに埋まることがあります。
レスポンス、モデル、残高
レスポンス
新しいOpenAIの例では /v1/responses が使用されます。ここでも利用可能なので、その形式用に書かれたコードを書き直す必要はありません。
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'クライアントが期待する方を使用してください。ゼロから始める場合は、チャット補完が最も幅広いツールサポートを持っています。
モデルと残高
キーが動作することを確認するためにモデルをリスト表示します。1つのエントリのみが表示されるはずです。uncensored。これはサービスが1つのモデルのみを実行し、ベンダー間のルーターではないためです。
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"また、すべてのレスポンスに X-Balance-USD ヘッダとして残高が含まれるため、追加のリクエストなしでアプリ内で低残高警告を表示するのに便利です。他のヘッダには、サポート質問用の X-Request-Id、および X-RateLimit-Limit-Requests と X-RateLimit-Limit-Concurrency が含まれます。
ツールとJSONモードの実利用
2つの機能により、チャットエンドポイントを製品構築の基盤にすることができます。ツール呼び出しでは、モデルがあなたのコードに対して関数の実行を依頼します。JSONモードでは、モデルが解析可能な出力を返すようになります。どちらも標準的なリクエストフィールドを使用します。
ツール呼び出しは次のようになります。モデルは tool_calls エントリを返し、あなたは関数を実行し、role: "tool" を持つメッセージとして結果を送り返します。
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)JSONモードでは、response_format={"type": "json_object"} を追加し、プロンプトでJSONを望むこと、できれば期待するキーを指定してください。常にtryブロック内で解析してください。どのモデルもすべての呼び出しでスキーマを保証するわけではないため、結果を信頼する前に検証してください。
既存の OpenAI プロジェクトの移行
すでにOpenAI SDKを使用している場合、移行は3つの編集だけで済み、新しいライブラリは不要です。ほとんどのSDKは同じ2つの環境変数を読み取るため、コードを変更せずに済むことが多いです。
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);次に、コード内のGPTモデルIDなどのモデル名を検索し、uncensored に置き換えてください。このサービスは単一のモデルを提供しているためです。embeddings、images、audioへの呼び出しを削除し、それらを別プロバイダーにルーティングしてください。以下のチェックリストを維持してください:Base URLの変更、モデル名の変更、APIキーを環境変数に格納してリポジトリに含めないこと、429に対するリトライロジック、残高ヘッダーに基づく残高アラート。キーの設定については uncensored AI APIキーの取得方法 を参照してください。その後、単一のテストリクエストを実行し、X-Balance-USD が返ってくることを確認してから、実際のトラフィックを切り替えてください。
提供されていない機能
ギャップを知ることで、デバッグに要する時間を1日節約できます。このAPIはテキストのみです。以下のOpenAIエンドポイントは利用できません:
- 画像とビジョン生成。 画像生成や編集はありません。
- 音声。 音声からテキストへ、またはテキストから音声への変換はありません。
- 動画。 提供されていません。
- 埋め込み。 検索機能を作成する場合は、別の埋め込みサービスが必要です。
- ファインチューニング。 サービス上でトレーニングすることはできません。
それらのパスへの呼び出しは失敗するため、共有クライアント設定から除外してください。典型的なセットアップでは、チャットにはこのAPIを、埋め込みには別のプロバイダーをペアリングし、アプリはタスクごとにBase URLを選択します。
制限、エラー、リトライ
フルキーは最大8件の同時リクエストと1分あたり300リクエストを許可します。トライアルキーは最大2件の同時リクエストと1分あたり60リクエストを許可します。ボディの最大サイズは8 MBです。制限を超過するとHTTP 429が返され、エラーコードでどちらの制限に達したかを示します:rate_limited は1分あたりのリクエスト数、concurrency は一度に多すぎるリクエストを示します。一時的な過負荷時には429が返され、Retry-After: 5 ヘッダーが含まれます。
人々を困らせる1つの詳細:ストリーミングリクエストはストリームが終了するまで同時実行スロットを保持するため、遅いリーダーは制限の対象となります。単純なリトライラッパーはこれらすべてを処理します:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")失敗または拒否されたリクエストは課金されないため、エラー時のリトライには追加コストがかかりません。バッチジョブの場合、リトライに依存するのではなく、フルキーではワーカープールを8に、トライアルキーでは2に制限してください。固定されたプールは理解しやすく、1つの低速なストリームが他のストリームを飢えさせないようにします。
コストとアクセス
料金は1M入力トークンあたり$0.15、1M出力トークンあたり$0.50です。サブスクリプションや期限切れのない前払いクレジットから課金されます。暗号資産(TRC20上のUSDT、Base上のUSDC)で、$20から$500までの任意の整数金額でチャージできます。大口チャージにはボーナスが付きます:$50から+5%、$100から+10%、$200から+15%。詳細は 価格ページ を参照してください。
試すには、Googleまたはメールでサインアップし、APIキーページ でワンクリックで$0.50のトライアルクレジットを請求してください。ドキュメント は各パラメータをカバーし、エンドポイント概要 はこのサービスの概要(法的に成人が使用できる用途向けの単一のオープンウェイトモデル、コンテンツ拒否なし、未成年者を含む性的コンテンツの厳格な禁止)を説明しています。
その他のガイド
質問と回答
ストリーミングと関数呼び出しに対応していますか?
はい。ストリーミングを有効にするには stream: true を使用し、関数呼び出しには tools と tool_choice を使用します。
埋め込みエンドポイントはありますか?
いいえ。テキストチャットのみのサービスなので、埋め込みには別のプロバイダを使用してください。
残高はどのように確認できますか?
GET /v1/balance または OpenAIスタイルの credit_grants パスを呼び出すか、あらゆるレスポンスの X-Balance-USD ヘッダーを読み取ってください。
レート制限に達するとどうなりますか?
レート制限または同時実行数の制限により HTTP 429 が返されます。待機して再試行してください。一時的な過負荷時には、Retry-After ヘッダーに 5 秒と表示されます。
キーはフォーム1つで入手できます
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。