Uncensored AI APIの統合方法

なぜUncensored AI APIを選ぶのか？

多くの商用LLMプロバイダは、クリエイティブな執筆やロールプレイ、論争的なトピックの技術分析をブロックする強力な安全フィルターを実装しています。無検閲AI APIはこれらの任意の拒否を除去し、コンテンツポリシーレイヤではなくトレーニングデータに基づいてモデルが回答できるようにします。これは、ポストプロセスフィルタなしで生のモデル出力を必要とするアプリケーション開発者に特に有用です。

複数のベンダーにリクエストをルーティングするモデルエグリーゲータとは異なり、このサービスは単一の専用モデルを提供します。これによりルーティングロジックの不確実性が解消され、リクエスト全体で一貫した動作が保証されます。このモデルは、法的な成人向けコンテンツ、セキュリティリサーチ、フィクションの物語に対する拒否を最小限に抑えるよう特別にチューニングされたオープンウェイトモデルです。

ただし、「uncensored」は無制限を意味するわけではありません。未成年者を含む性的なコンテンツについては、硬性の制限が維持されます。それ以外のほとんどのユースケース（大人向けテーマや非伝統的なロジックを含む）では、モデルはレスポンスを生成します。このアプローチは、プロバイダーの嗜好に依存せずにアプリケーションのコンテンツ戦略を完全に制御したい開発者に最適です。

環境のセットアップ

統合は、OpenAI互換SDKを正しいベースURLにポイントすることから始まります。エンドポイントはhttps://api.uncensoredai.top/v1にホストされています。これにより、クライアントロジックを書き換えることなく、公式のOpenAI PythonまたはNode.jsライブラリを使用できます。base_urlパラメータを更新し、APIキーを提供するだけです。

このサービスは100,000トークンのコンテキストウィンドウをサポートしており、多くの標準的な提供サービスよりも大幅に大きくなっています。これにより、広範なプロンプト履歴や大規模なドキュメント処理が可能です。ただし、1つのリクエストあたりの最大出力は32,000トークンです。max_tokensを指定しない場合、デフォルトは2,048トークンです。

• SDK互換性: OpenAI Chat Completionsプロトコルをサポートするすべてのクライアントで動作します。
• コンテキストウィンドウ: 合計100kトークン（入力＋出力）。
• 最大出力: 1リクエストあたり16kトークン。

レイテンシの問題を避けるために、環境変数が正しく設定されていることを確認してください。このAPIはコードファーストの直接統合を目的としているため、学習すべきWebインターフェースはありません。HTTPリクエストを通じてのみ対話します。

認証とヘッダー

認証は標準のAuthorizationヘッダーによって処理されます。サインアップ時に単一のAPIキーが提供されます。アカウントごとに複数のキーを発行するサービスとは異なり、このプラットフォームはアカウントあたり1つのアクティブなキーのみを許可します。新しいキーを生成すると、以前のキーは直ちに無効化されます。

リクエストを認証するには、ヘッダーAuthorization: Bearer YOUR_API_KEYを含めてください。サービスはまた、利用可能なモデル情報（モデルIDuncensoredを含む）を返すGET /v1/modelsエンドポイントも提供します。これは複雑なペイロードを送信する前に接続を確認するのに役立ちます。

レート制限:

• キーあたり1分あたり300リクエスト。
• キーあたり同時に8リクエスト。
• 最大リクエストボディサイズ8 MB。

これらの制限はほとんどのアプリケーションにとって寛容ですが、429エラーを避けるために尊重する必要があります。サブスクリプションプランがないため、これらの制限はクレジット残高に関係なく、すべてのユーザーに均一に適用されます。

最初の完了リクエストの送信

基本的なリクエストは標準的なChat Completionsの形式に従います。modelにuncensoredを、messages配列に値を設定したJSONペイロードを送信します。サービスはテキストレスポンスを返します。埋め込み、ビジョン、音声のエンドポイントは提供されません。これは純粋なテキストAPIです。

リクエスト例:

以下は標準的なチャット補完の例です。YOUR_API_KEYを実際のキーに置き換えてください。

Copycurl https://api.uncensoredai.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

応答にはchoices[0].message.contentに生成されたテキストが含まれます。エラーは標準的なHTTP形式で返されるため、リトライや失敗を適切に処理できます。エラーはクレジットを消費しないため、自由にテストできます。

OpenAIに精通した開発者にとって、体験は同一です。異なるのはベースURLとコンテンツフィルターに関するモデルの動作だけです。この一貫性は、すでにOpenAI互換ツールを使用しているチームの学習コストを削減します。

ストリーミング応答の処理

ストリーミングはServer-Sent Events (SSE)を介してサポートされます。これにより、トークンが生成されるたびに受信でき、長い応答に対してユーザーエクスペリエンスが向上します。ストリーミングエンドポイントは非ストリーミング用と同じです。リクエストでstream: trueを設定するだけです。

ストリーミングの利点:

• ユーザーの体感レイテンシを低減します。
• リアルタイムでの部分的結果の表示。
• トークンが逐次処理されるため、効率的なメモリ使用。

ストリーミング応答の最後のチャンクにはトークン使用統計が含まれます。これは正確な課金に不可欠で、消費されたトークンの正確な数を追跡できます。ストリーミング中のエラーは部分的な応答をもたらす可能性があるため、クライアントは不完全なチャンクを適切に処理する必要があります。

コード例:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredai.top/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

クライアントライブラリがSSEストリームを正しく処理していることを確認してください。最新のSDKはこれを抽象化しますが、接続の問題や解析エラーのデバッグには基礎的なプロトコルの理解が役立ちます。

高度な機能: JSONモードとツール

APIはresponse_formatを{"type": "json_object"}に設定することで構造化出力をサポートします。これによりモデルは有効なJSONを返すよう強制され、他のソフトウェアシステムとの統合に不可欠です。この機能はデータ抽出や設定ファイルの生成に特に役立ちます。

関数呼び出しもサポートされています。リクエストでツールを定義すると、モデルは応答でツール呼び出しを返します。これにより、LLMが外部アクションをトリガーできる複雑なワークフローが可能になります。tool_choiceパラメータにより、特定のツールを強制するか、モデルに判断を任せることができます。

主要パラメータ:

• temperature: ランダム性を制御。
• top_p: 多様性を制御。
• stop: 停止シーケンスを定義。
• seed: 決定論的な応答用。

これらの機能により、このAPIは信頼性の高い構造化データを必要とする本番環境のアプリケーションに適しています。モデルは無検閲ですが、要求された場合は構造的制約に従います。この自由と構造のバランスは、複雑なエージェントを構築する開発者にとっての主要な利点です。

利用状況と制限の監視

利用状況はAPIキーごとに追跡されます。ダッシュボードには現在のクレジット残高と最近のリクエスト履歴が表示されます。請求は実際のトークン使用量に基づいて行われるため、コストをリアルタイムで監視できます。エラーや拒否には課金されないため、テストフェーズでコストを抑えることができます。

利用指標：

• 入力トークン：1Mトークンあたり$0.25で課金されます。
• 出力トークン：1Mトークンあたり$1.00で課金されます。
• エラー：無料。

クライアントライブラリが対応している場合はアラートを設定できますが、主な監視はアカウントダッシュボードを通じて行われます。1分あたり300リクエストの制限は、すべてのユーザーに公平な利用を保証するためのものです。この制限を超えると、429ステータスコードが返されます。

高ボリュームアプリケーションでは、リトライに指数関数的バックオフを実装することを検討してください。サービスは信頼性を重視して設計されていますが、ネットワークの問題やレート制限が発生する可能性があります。クレジットは期限切れにならないため、トークン使用状況を追跡することで、特に予算管理を効果的に行うことができます。

暗号通貨によるクレジットの管理

支払いは暗号通貨のみで処理されます。USDT（TRC20）またはUSDC（Base）でアカウントにチャージできます。最小チャージ額は$10、最大額は$500です。月額サブスクリプションや継続的な料金はありません。

ボーナスクレジット：

• 50ドルチャージ：+5%ボーナスクレジット付き。
• $100チャージ：ボーナスクレジット10%増。

クレジットは期限切れにならないため、一度チャージして時間とともに使用できます。トークン消費量が変動する長期プロジェクトに最適です。クレジットカードの処理手数料がかからないため、安定コインを既に保有している開発者にとって、暗号通貨はコスト効率の高い選択肢となります。

支払いプロセス：

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

お支払いには、ダッシュボードから入金アドレスを生成し、暗号通貨を送信してください。クレジットは自動的に追加されます。クレジットの返金はできませんが、二重請求などのエラーはサポートページを通じて修正されます。このモデルは、銀行の制限に直面する可能性のあるグローバルな開発者の手間を減らします。