JA ▾
API キーを取得

Uncensored Endpoint:ベースURL、モデルID、制限

ここでのuncensoredエンドポイントとは、法的に成人が使用できる用途でコンテンツ拒否なしで回答するホスト型OpenAI互換テキストAPIを意味します。このページには、コードを書く前に必要な正確なベースURL、モデルID、メソッド、制限、エラーコードが記載されています。

更新日:

主要ポイント

  1. ベース URL は https://api.uncensoredendpoint.com/v1 で、唯一のモデル ID は uncensored です。
  2. 利用可能なメソッドは2つあります:POST /v1/chat/completions と GET /v1/models です。
  3. コンテキストウィンドウは100,000トークンで、プロンプトと補完を合わせた合計です。
  4. フルキーは8つの同時リクエストと1分あたり300リクエストを許可します。
ラップトップとAPIサーバーを結ぶデータパイプのアイソメトリックイラスト

接続設定の概要

値のみが必要な場合はこちらをご覧ください。ページの他の部分は、実際の動作について説明しています。

設定内容
ベース URLhttps://api.uncensoredendpoint.com/v1
モデル IDuncensored
認証ヘッダーAuthorization: Bearer YOUR_KEY
エンドポイントPOST /v1/chat/completions、GET /v1/models
コンテキストウィンドウ100,000 トークン(プロンプトと補完を含む)
最大リクエストボディ8 MB
キーの完全な制限8つの同時リクエスト、1分あたり300リクエスト
試用キーの制限同時リクエスト2件、1分あたり60リクエスト
料金入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50

このサービスはOpenAIチャット完了APIと同じワイヤーフォーマットを使用します。カスタムベースURLとAPIキーを入力できるツールがあれば、これに接続できます。キーはAPIキーページで入手でき、ドキュメントには短い形式で同じリファレンスが記載されています。

各メソッドの役割

ルートは2つだけなので、対象範囲が狭く保たれています。

  • GET /v1/modelsはモデルリストを返します。1つのエントリuncensoredが表示されます。多くのクライアントはこのルートを使用してモデルドロップダウンを埋めるため、キーとURLが正しいことを確認する簡単な方法にもなります。
  • POST /v1/chat/completionsが主力メソッドです。メッセージのリストを受け取り、1つのJSONレスポンスまたはサーバー送信イベント(SSE)ストリームとして補完結果を返します。

従来のテキスト補完ルート、レスポンスルート、埋め込み、画像ルート、音声ルートは製品に含まれていません。ライブラリがそれらを使用しようとするとエラーが発生するため、ライブラリをチャットモードに切り替えてください。

ターミナルからの簡単なチェック:

curl https://api.uncensoredendpoint.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

uncensoredを含むJSONリストは、キーが有効であることを意味します。HTTP 401は、キーが不足している、誤入力されている、またはシェル変数から取得した際にキーに余分なスペースや改行が含まれていることを示します(これが最も一般的な原因です)。

curl、Python、Nodeでの最初のリクエスト

3つの例はすべて同じものを送信します:1つのシステムメッセージ、1つのユーザーメッセージ、低い温度です。YOUR_KEYを置き換えるか、API_KEY環境変数を設定してください。

curl https://api.uncensoredendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what a context window is in two sentences."}
    ],
    "temperature": 0.7
  }'

公式Python SDKでは、クライアントに2つの追加引数だけを渡すだけで済みます:

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": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

同じSDKを使用したNodeでは次のようになります:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredendpoint.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain what a context window is in two sentences." },
  ],
});
console.log(resp.choices[0].message.content);

レスポンスには、プロンプトと完了のトークン数を含むusageオブジェクトが含まれます。これには注意してください:これらの2つの数字が課金の対象となります。レスポンスヘッダーにはX-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrencyも含まれます。問題が発生した場合、サポートはまずリクエストIDを尋ねるため、すべての呼び出しでリクエストIDをログに記録してください。

ストリーミング、ツール呼び出し、JSON モード

3つの機能は実際のアプリケーションの大部分をカバーし、これらすべてはすでに知っているOpenAIの形状に従っています。

ストリーミング

stream: trueを設定し、サーバー送信イベントを読み取ります。使用状況はストリームの最後に報告されるため、2回目のリクエストなしでトークンをカウントできます。キャパシティプランニングにとって重要な点があります:ストリーミングリクエストはストリームが終了するまで同時実行数のスロットを保持します。低速なクライアントが長い回答を少しずつ読み取ると、スロットを長時間占有し続けます。

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

関数呼び出し

toolsとオプションでtool_choiceを渡します。モデルが関数を呼び出すと判断すると、返信にtool_callsが含まれます(ストリーミングしている場合はストリーミングも)。関数を自分で実行し、role: "tool"を持つメッセージとして結果を戻します。モデルは単一のオープンウェイトモデルであるため、いくつかの現実的なプロンプトでツールスキーマをテストし、パラメータの説明を短く具体的にしてください。

JSON モード

有効なJSON出力をリクエストするにはresponse_format: {"type":"json_object"}を送信します。プロンプトでJSONを望んでいることと、期待するフィールドを説明することも伝えてください。それでも防御的に解析し、出力を盲目的に信頼するのではなく、解析失敗時に1回再試行してください。

サンプリング制御は渡されます:temperature、top_p、stop、seed、および頻度ペナルティと存在ペナルティ。

10万トークンのウィンドウの実践

コンテキストウィンドウは100,000トークンで、これはプロンプトと補完を合わせた合計です。補完はプロンプトの空き容量に応じて利用でき、max_tokensはオプションです。プロンプトに90,000トークンを送信した場合、回答に使えるのは最大で約10,000トークンです。

英語テキストでは、1トークンは1語よりやや少ない長さとなるため、100,000トークンは約70,000語に相当します。これは、長編の原稿章セットやコードベースの大きな部分、あるいは数時間にわたるチャット履歴に十分な量です。これを有用に使うための3つの習慣があります。

  • 意図的に履歴をトリムする。チャットクライアントはターンごとに会話全体を再送信するため、コストとレイテンシがそれに応じて増加します。システムプロンプト、古いターンの要約、最後の数メッセージのみを保持してください。
  • 出力サイズが重要な場合はmax_tokensを設定してください。これはオプションですが、長いプロンプトに対して想定外の長い回答が生成されるのを防ぎます。
  • 8 MBのボディ制限に注意する。これはトークンウィンドウとは別です。プレーンテキストは8 MBに達することはめったにありませんが、プロンプトに貼り付けられたbase64ブロブは達する可能性があります。

課金はトークン単位であるため、フルウィンドウのリクエストは短いリクエストと比較して実際に費用がかかります。価格ページにはレートが記載されており、任意のリクエストのコストは、入力トークン数に$0.15を掛けて100万で割った値に、出力トークン数に$0.50を掛けて100万で割った値を加算して計算できます。

レート制限と429ファミリー

フルキーは同時に8リクエスト、1分あたり300リクエストまで許可します。トライアルキーはより厳しく、同時に2、1分あたり60です。制限を超えるとAPIはHTTP 429を返し、エラーコードがどの制限を超えたかを示します:

エラーコード意味取るべき行動
rate_limited1分あたりのリクエスト数が多すぎるスローダウンし、呼び出しを1分全体に分散させる
concurrency同時リクエスト数が上限を超えていますクライアント側でキューに追加し、並列ワーカーを8(トライアルでは2)に制限する
429 と Retry-After: 5一時的な過負荷5 秒待ってから再試行する

最も簡単な防御策は、キーの制限に合わせて独自のコードにセマフォを設定することです。Pythonのasyncioでは、各呼び出しの周りにasyncio.Semaphore(8)を配置すると、concurrencyエラーが完全に解消されます。Retry-Afterヘッダーを尊重し、ヘッダーがない場合は短い指数遅延にフォールバックする再試行を追加してください。ストリームは全長にわたってスロットを保持するため、8本の長いストリームのバッチは、1分あたりのカウントが低くても、9番目のリクエストをブロックする可能性があります。

失敗または拒否されたリクエストは課金されないため、再試行ループは失敗した試行に対してコストがかかりません。

モデルとは何か、そして何ではないか

このサービスは、独立したプロバイダによってホストされ、法的な成人向け用途でコンテンツ拒否なしで回答するように調整された単一のオープンウェイトモデルで動作します。大手ベンダーの公式APIではなく、ベンダー間で選択するルーターでもありません。単一のモデルuncensoredのみであるため、選択する余地もなく、比較する価格帯もありません。

制限は明確です。テキストが入力され、テキストが出力されます。画像、音声、動画の生成、埋め込み、ファインチューニングはありません。唯一の固定コンテンツルールは、未成年者を含む性的コンテンツが常に許可されていないことです。プロンプトはトレーニングには使用されません。

この枠組みはプロジェクトを計画する際に役立ちます。成人向けのフィクションやロールプレイツール、コンパニオンアプリ、モデル挙動の研究、モデルが後退せずに率直または機密性の高いテキストを処理するツールはすべて自然な適合です。検索用の埋め込みが必要な場合は、その部分に別のプロバイダが必要ですが、生成にはこのエンドポイントを引き続き使用できます。

本番環境へ移行する前に

動作するデモは5分の作業です。信頼できるサービスにはもう少し時間がかかります。トライアルから始めましょう:新規ユーザーは、サインアップ後にキーページでワンクリックで$0.50のクレジットを請求できます。1人1回限り、7日間有効、支払い不要です。サインアップはGoogleまたはメールとパスワードで可能です。これは、統合を確認するための数百回の短いテスト呼び出しに十分です。

実際のトラフィックに移行する際は、$20から$500までの任意の整数金額でチャージしてください。支払いは暗号資産(TRC20上のUSDT、Base上のUSDC)で行います。クレジットは期限切れにならず、サブスクリプションもないため、残高は消費するまでそのまま保持されます。ボーナスは$50から5%、$100から10%、$200から15%です。

その後、以下の短いリストに従ってください:キーを環境変数またはシークレットマネージャに保存し、クライアント側のコードには保存しない;X-Request-Idをログに記録する;X-Balance-USDを監視して、残高が枯渇する前に通知を出す;並列ワーカー数を制限する;429エラーに対して即時再試行のループではなく遅延処理を行う。APIキーの本番環境チェックリストではキー処理の詳細を詳しく説明しており、ドキュメントにはパラメータリファレンスが記載されています。

質問と回答

特別なSDKが必要ですか?

いいえ。OpenAI SDK またはクライアントはどれでも動作します。Base URL とキーを変更し、モデルを uncensored に設定すれば、残りのコードは変更の必要がありません。

画像や埋め込みを生成できますか?

いいえ。API はテキストのみです。画像、音声、動画の生成、埋め込み、ファインチューニングはありません。

レート制限に達するとどうなりますか?

HTTP 429 が返されます。1分あたりのリクエスト数を超えた場合はエラーコードが rate_limited になり、同時に実行されるリクエストが多すぎる場合は concurrency になります。少し待ってから再試行してください。

コンテンツに関するハードルールはありますか?

はい。未成年者を含む性的コンテンツは常に禁止されています。それ以外は、法的な成人向け利用において拒否せずに回答するようにモデルが調整されています。

キーはフォームを1つ記入するだけで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

APIキーを取得ドキュメントを読む