Uncensored AI Integration Guide

無制限のAPIに切り替える理由

開発者が切り替える主な理由は、クリエイティブなワークフローやロールプレイシナリオを妨げる任意のコンテンツ拒否を排除することです。標準的なモデルは、過度に厳格な安全チューニングにより、無害なリクエストをブロックすることがよくあります。アンセンサードAPIは、そのような人工的な制約なしに回答するようチューニングされた単一のモデルを提供します。このアプローチにより、異なるプロンプト間で一貫した動作が保証されます。モデルが予期せず切り替わる可能性のあるルーティングプロキシではなく、専用エンドポイントが提供されます。課金は前払い式のため、何に対して支払うのかを正確に把握できます。月額サブスクリプションや隠れた手数料はありません。エラーが発生してもクレジットは消費されません。この透明性は、予測可能なコストを必要とする予算重視の開発者にとって極めて重要です。複数のモデルエンドポイントを管理する複雑さを回避できます。単一モデルに焦点を当てることで、特定の動作パターンに合わせてプロンプトを最適化できます。これにより、問題発生時のデバッグ時間を短縮できます。出力スタイルとコンテンツの境界線に対する完全な制御を維持できます。

環境の設定

お好みの言語の公式OpenAI SDKをインストールすることから始めましょう。これにより標準的なエンドポイント構造との互換性が確保されます。新しいアカウントを作成してAPIキーを生成してください。プロセスにはメールアドレスまたはGoogleログインのみが必要です。基本的なアクセスには電話番号の確認は必要ありません。エンドポイントをテストするための即時の試用クレジットが付与されます。キーは一度だけ表示され、安全に保管する必要があります。環境変数を使用して、キーをバージョン管理から除外してください。これは本番環境でのデプロイにおける標準的なプラクティスです。SDKはキーを渡すことで自動的に認証を処理します。ヘッダ構造を手動で変更する必要はありません。クライアントライブラリはHTTPリクエストを効率的に管理します。このセットアップはローカル開発とクラウドサーバーの両方で機能します。不正使用を防ぐためにキーを安全に保管してください。試用クレジットにより、さらに購入する前に接続を確認できます。

ベースURLの構成

クライアントをuncensoredサービスの専用ベースURLに接続してください。このURLは、設定内のデフォルトのOpenAIエンドポイントを置き換えます。SDKクライアントインスタンス内のベースURLフィールドを更新する必要があります。標準のモデルIDは "uncensored" に設定されます。これはサーバーにどの特定のモデルを実行するかを指示します。エンドポイントは標準のチャット補完パラメータをサポートしています。ランダム性を制御するために温度とtop_pを調整できます。コンテキストウィンドウは合計で最大100,000トークンをサポートしています。これにより、長い会話や大規模なドキュメント処理が可能になります。出力は1リクエストあたり16,000トークンに制限されます。必要な形式で標準メッセージを送信できます。APIはモデルのトレーニングと一貫したテキストレスポンスを返します。ストリーミングはリアルタイムフィードバックのためにデフォルトで有効になっています。この設定により既存のコードベースとの互換性が保証されます。統合ロジック全体を書き直す必要はありません。移行は最小限で、ほぼ自動的です。

最初のリクエスト

セットアップを確認するために、シンプルなチャット完了リクエストを送信してください。ユーザープロンプトを含む標準的なメッセージ形式を使用します。レスポンスには生成されたテキストが直接含まれます。レスポンスのメタデータでトークン使用量を確認してください。これにより、課金が正しく使用量を追跡していることが確認できます。このモデルは、法的な成人向けコンテンツに対して拒否なしで応答します。さまざまなトーンやスタイルをすぐにテストできます。エンドポイントは専用サーバー上で推論を処理します。標準的なHTTPレスポンスとして結果を受け取ります。基本的なテキスト生成には追加のヘッダーは必要ありません。このプロセスは、任意のOpenAI互換サービスへの呼び出しと同じです。この一貫性は、新しいチームの学習コストを削減します。既存のアプリケーションにこの機能をすばやく統合できます。前払いクレジットは、トークン生成が成功した場合のみ差し引かれます。失敗したリクエストは残高を消費しません。これにより、テストはコスト効果が高く、予測可能になります。

ストリーミングレスポンスの処理

ストリーミングを有効にして、トークンが生成されるたびに受信します。これはインタラクティブなアプリケーションのユーザー体験を向上させます。サーバーはServer-Sent Eventsを介して部分的な応答を送信します。クライアントはこれらのイベントを解析してテキストを逐次表示します。最終チャンクには総トークン使用量の詳細が含まれており、リアルタイムでコストを追跡できます。ストリーミングはエンドユーザーにとっての知覚されるレイテンシを軽減します。ユーザーが入力を停止した場合、生成を中断できます。SDKはイベントの解析を自動的に処理します。接続を手動で管理する必要はありません。ストリームはネットワークの中断後スムーズに再開します。この機能はチャットインターフェースに不可欠です。より動的で魅力的なインタラクションを提供します。モデルはトークンごとにテキストを生成します。このアプローチは最新のLLMアプリケーションの標準です。ストリーミングを関数呼び出しと組み合わせることで、複雑なタスクを実行できます。データフローは効率的で信頼性があります。

Function Callingを使用

ツール使用を有効にするため、リクエストペイロード内に関数スキーマを定義します。条件が満たされた場合、モデルは構造化データを返します。異なるタスク用に複数のツールを指定できます。APIはtool_choiceと自動選択の両方をサポートしています。これにより、モデルの動作を精密に制御できます。スキーマに一致するJSON出力が得られます。エラー処理はレスポンス形式に組み込まれています。関数を実行する前に出力を検証できます。これは自動化されたワークフローやエージェントにとって重要です。モデルは関数の説明を明確に理解します。自由テキストを手動で解析する必要はありません。この構造により、異なるプロンプト間で一貫性が確保されます。異なるコンテキストに合わせてスキーマを動的に更新できます。この機能は複雑なマルチステッププロセスをサポートします。APIはツール結果をモデルに戻すルーティングを処理します。意思決定プロセスを完全に把握できます。

トークンとコストの管理

前払いの予算内に収まるようにトークン使用量を監視してください。入力トークンは100万トークンあたり$0.15で課金されます。出力トークンは100万トークンあたり$0.50で課金されます。この差は生成の計算コストを反映しています。大きなリクエストを送信する前にコストを計算できます。APIはすべてのレスポンスでトークン数を返します。これにより、費用の正確な予測が可能です。エラーや拒否は無料なので、価値のあるものに対してのみ支払います。月額料金やサブスクリプションの縛りはありません。いつでも暗号通貨でチャージできます。クレジットは期限切れにならないため、使用を一時停止できます。この柔軟性は、需要が変動するプロジェクトに最適です。アイドル状態の容量に対して支払う必要がありません。前払いモデルは透明性と制御性を保証します。支出する前に、正確な支出額がわかります。これは予算を重視する開発者に特に有用です。

OllamaとAPIのよくある質問

Ollamaはローカルマシンでモデルを実行するため、独自のハードウェアが必要です。APIはリモートサーバーでモデルを実行し、インターネット接続のみが必要です。ローカル推論はGPUとRAMの容量に依存します。APIはデバイスに関わらず一貫したパフォーマンスを提供します。モデルのダウンロードや更新の管理は不要です。APIはほとんどのローカル環境よりも長いコンテキストウィンドウをサポートします。ハードウェアのアップグレードなしで利用量をスケールできます。APIは高い稼働率が必要な本番環境に適しています。ローカルのOllamaはプライバシー重視またはオフライン用途に最適です。インフラストラクチャとレイテンシ要件に応じて選択してください。両方のアプローチは同じ基盤となるモデルアーキテクチャを提供します。APIは既存のクラウドサービスとの統合が容易です。ローカル依存関係の管理の複雑さを回避できます。選択は特定のデプロイメントの制約に依存します。

レート制限のトラブルシューティング

キーごとに1分間に300リクエストまで制限されています。これを超えると、APIは429エラーを返します。指数関数的バックオフ付きのリトライロジックを実装する必要があります。並列リクエストはキーごとに最大8つに制限されます。これにより、並列タスクによるサーバーの過負荷を防ぎます。ニーズに応じて同時実行数を調整できます。制限はキーごとなので、追加のキーを作成できます。アカウントには1つのアクティブなキーのみがサポートされています。新しい制限を取得するには、古いキーを置き換えてください。リクエストボディのサイズは8 MBに制限されています。大きな入力はこの制限を超える可能性があります。必要に応じてデータを小さなチャンクに分割してください。使用状況を監視することで、制限内に収めることができます。APIはデバッグ用の明確なエラーメッセージを提供します。アプリケーションの負荷に基づいてレート調整できます。これにより、ピーク時の安定したパフォーマンスが確保されます。スロットリングを避けるためにトラフィックを計画してください。