Uncensored API よくある質問

基本情報

Uncensored APIを一言で説明すると？

単一のモデル（id: uncensored）を提供し、法的なアダルトコンテンツ、フィクション、論争的な主題を拒否しない、テキスト専用のチャット完了エンドポイントです。

どのURLを呼び出しますか？

ベースURLとしてhttps://api.uncensoredapis.com/v1を使用します。チャットリクエストはPOST /v1/chat/completionsへ、モデル一覧はGET /v1/modelsへ送信します。それ以外のパスは404を返します。

新しいSDKを学ぶ必要がありますか？

いいえ。リクエストとレスポンスの形式は一般的なチャット完了の規約に従っているため、ベースURLとキーを変更するだけで公式のPythonおよびNodeパッケージが動作します。Plain curlも使用可能です。これはdocsで確認できます。

支払い前に試す方法はありますか？

はい。新規アカウントには7日間有効な$0.50のトライアルクレジットが付与され、サインアップ時に支払い情報は求められません。キーページでメールアドレスとパスワードで登録すると、キーが即座に表示されます。

複数のモデルから選択できますか？

いいえ。モデルは1つだけで、そのidはuncensoredです。モデル一覧エンドポイントへの呼び出しは単一のエントリを返すため、選択や切り替えの必要はありません。

このサービスは誰向けですか？

フィクションツール、ロールプレイアプリ、研究アシスタントなど、大人向け製品を構築する開発者向けです。上位に構築するコンテンツの年齢確認とコンテンツルールは自己責任となります。

キーとアクセス

アカウントにはどのくらいのキーが付与されますか？

1つです。新しい値が必要な場合はアカウントから再生成できますが、以前のキーは同時に無効になるため、置き換えをすぐにデプロイしてください。

キーはどこに保存すべきですか？

制御するサーバー上の環境変数またはシークレットマネージャーに保持してください。ブラウザJavaScriptやモバイルバイナリは解析される可能性があるため、キーを埋め込むのではなく、クライアントトラフィックを自前のバックエンド経由でルーティングしてください。

キーはどのように送信されますか？

すべてのリクエストでAuthorization: Bearerヘッダーに含まれます。不足または誤った値の場合、401ステータスとJSONエラーオブジェクトが返されます。

チーム用の無検閲APIキーが欲しいです。共有できますか？

可能です。ただし、すべてのプロセスが同じ1分あたり300リクエストの制限と残高を共有します。キーの前に小さなゲートウェイを配置し、各チームメイトにキーではなくゲートウェイへのアクセスを付与してください。

制限と料金

プロンプトのサイズはどのくらいまで可能ですか？

コンテキストウィンドウは100,000トークンで、プロンプトとcompletionで共有されます。単一リクエストのボディは8 MBを超えてはなりません。プロンプトとmax_tokensの合計がウィンドウを超えると、400エラーで拒否されます。

返信の長さはどのくらいまで可能ですか？

デフォルトは2048トークンです。リクエストごとにmax_tokensを最大32,000まで引き上げることができます。上限により応答が停止した場合、finish_reasonはlengthになります。

料金はどのくらいですか？

入力トークンは100万トークンあたり$0.25、出力トークンは100万トークンあたり$1.00です。残高は前払いで、サブスクリプションはなく、残高は期限切れになりません。詳細は料金ページをご覧ください。

簡単な見積もりを教えてください。

例として、1,500トークンのプロンプトと300トークンのcompletionを含むチャットターンを想定します。入力は$0.000375、出力は$0.0003で、ターンあたり約$0.000675、つまり$1で約1,480回のターンが可能です。

リクエストが多すぎるとどうなりますか？

各API キーは1分あたり300リクエストまで送信可能です。それを超えると429が返され、適切な対応はスローダウンし、遅延を設けて再試行することです。

統合に関する質問

設定できるサンプリングパラメータはどれですか？

temperature、top_p、stopなどの標準パラメータは生成処理に渡されます。リクエストボディには他の場合と同じように設定してください。

APIは以前の会話履歴を記憶しますか？

いいえ。各リクエストは独立しているため、messagesに会話全体を毎回再送信する必要があります。合計が100,000トークンのウィンドウに近づいたら、最も古いターンを削除してください。

ブラウザにトークンをストリーミングできますか？

はい、stream: trueを送信し、サーバー送信イベントを読み取ってください。バックエンドから実行し、テキストをページに中継することで、API キーがクライアントに到達しないようにします。

システムメッセージはサポートされていますか？

はい。会話のトーン、形式、境界を設定するには、配列の最初にsystemのroleを持つメッセージを配置してください。

出力が途切れている場合、最初に何を確認すべきですか？

finish_reasonを確認してください。値がlengthの場合、上限に達したことを意味するため、max_tokensを増やすか、プロンプトを短くしてください。すべての値はreferenceに記載されています。

残高と請求

資金を追加するには？

アカウントから前払い残高にチャージしてください。サブスクリプションはなく、未使用の残高は期限切れにならないため、いつでも利用可能です。

トライアルクレジットが使い切れたらどうなりますか？

無料トライアルクレジットは7日間有効です。使い切られたか期限が切れると、残高をチャージするまで402が返され、コードはno_creditになります。

リクエストの料金を確認できますか？

各レスポンスには、プロンプト、completion、合計トークンを含むusageブロックが含まれます。100万トークンあたりのレートで乗算して料金を算出し、台帳が欲しい場合は自分で記録を保持してください。

失敗したリクエストは無料で再試行できますか？

再試行は可能ですが、制限を設けてください。429および503には短いバックオフを使用し、400、401、402、403ではループしないようにしてください（これらは自己修正しないため）。errors playbookには既製のポリシーが用意されています。

コンテンツと動作

モデルは何をしないのですか？

合法的な成人向けコンテンツやフィクション、論争的なトピックは拒否されません。例外は未成年者を含む性的コンテンツで、これらはストーリーやロールプレイを含むあらゆる場面で403エラーとしてブロックされます。サービスは18歳以上の成人向けです。

プロンプトはモデルの学習に使用されますか？

いいえ。プロンプトは学習に使用されません。

エグリーゲーター経由でルーティングすることとどう異なりますか？

エグリーゲーターは複数のモデルにリクエストを転送しますが、それぞれに独自のルールがあります。本サービスは単一のモデルと単一のポリシーに基づいています。この比較の詳細はuncensored OpenRouter guideをご覧ください。

画像の読み取りや埋め込みの生成はできますか？

いいえ。テキストのみを処理し、埋め込み、画像、オーディオ、ビデオ、ファインチューニングはサポートしていません。

トラブルシューティング

402エラーでno_creditと表示されます。どうすればよいですか？

残高が枯渇したか、トライアルが期限切れになりました。前払い残高にチャージし、再度リクエストを送信してください。

リクエストが503 upstream_busyを返します。

これは一時的なものです。数秒待ってから再試行してください。複数のワーカーを実行する場合は、増分遅延とランダム性を組み合わせてください。

ストリーミングが終了し、トークン数が見つかりません。

ストリーミングを有効にすると、data: [DONE]の直前に、usageを含む最終チャンクが自動的に追加されます。このチャンクのchoicesリストは空であるため、インデックスを作成する前にこれを確認してください。

ツールや関数呼び出しは機能しますか？

はい、標準形式で動作します。tools配列を渡し、レスポンスのtool_callsを確認してください。