APIドキュメント

認証とベースURL

APIは認証に単一のAPIキーを必要とします。Googleまたはメールアドレスでサインアップすると、このキーが即座に取得できます。 Authorization Bearer トークンとしてヘッダーを設定します。ベース URL は https://api.topuncensored.com/v1このURLは、任意のOpenAI互換SDKまたはクライアントライブラリと連携します。

• ヘッダー: Authorization: Bearer YOUR_API_KEY
• クライアントのベースURLを提供されたエンドポイントに設定してください

この構成により、コアロジックを変更せずにライブラリを交換できます。

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

チャット完了エンドポイント

テキストプロンプトを /v1/chat/completions エンドポイント。モデルIDは uncensored. このエンドポイントはメッセージによる標準的なチャットフォーマットを処理します。テキスト応答を直接返します。余分な層やラッパーはありません。100,000トークンのコンテキストウィンドウを制御できます。8 MB未満のリクエストは確実に動作します。直接テキスト生成に使用してください。

systemプロンプトとuserメッセージでリクエストを構成します。モデルは合法的な成人向けコンテンツをフィルタリングせずに応答します。キーの欠落などのエラーは401を返します。クレジットが尽きた場合、402エラーが発生します。これらは明確なシグナルです。

ストリーミングレスポンス

streamをtrueに設定してストリーミングを有効にする stream: true生成されるたびにテキストチャンクを受け取ります。これにより、長い出力の知覚されるレイテンシが軽減されます。最後のチャンクにはトークン使用データが含まれます。リアルタイム表示やプログレッシブレンダリングに使用します。これは高ボリュームアプリケーションにとって効率的です。

各チャンクを解析して最終的なレスポンスを構築します。この方法は大きな出力を適切に処理します。APIは標準のServer-Sent Eventsをサポートしています。これはインタラクティブなアプリにとって推奨されるアプローチです。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.topuncensored.com/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)

ツール呼び出しとJSONモード

構造化された対話のために関数呼び出しを使用します。リクエスト内でツールを定義します。モデルは構造化された引数を返します。 response_format に {"type": "json_object"} 厳格なJSON出力のため。これにより予測可能なデータ形式が保証されます。これらの機能を組み合わせることで堅牢な統合が可能です。出力構造に対して正確な制御が得られます。

ツール呼び出しは標準的なOpenAIスキーマで動作します。JSONモードは有効なJSONを強制します。これらをAPI統合やデータ抽出に使用します。この柔軟性は複雑なワークフローをサポートします。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.topuncensored.com/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);

パラメータと制限

調整 temperature, top_p、および stop シーケンス。設定 max_tokens 最大16,000。省略した場合はデフォルトで2,048となります。繰り返しを制御するには presence_penalty および frequency_penalty. 使用 seed 決定論的な出力のため。これらのパラメータは生成品質を微調整します。出力スタイルに対して完全に制御できます。

レート制限は1分間あたり300リクエストです。同時実行数は8に制限されます。これらの制限は安定したパフォーマンスを保証します。ダッシュボードで使用状況を監視してください。特定のユースケースに合わせてパラメータを調整して最適化してください。

エラーとコンテキストウィンドウ

エラーを適切に処理してください。401は無効なキーを意味します。402は残高不足を示します。429はレート制限をシグナルします。コンテキストウィンドウは合計100,000トークンです。出力は最大16,000トークンに制限されます。トークンを賢明に管理してください。エラーはクレジットを消費しません。これはデバッグ時にコストを節約します。使用状況統計には最後のチャンクを使用してください。

トークン使用状況を追跡します。レートリミットに達しないようにします。指数関数的バックオフで再試行します。これにより、信頼性の高い運用が保証されます。APIは堅牢性のために設計されています。エラーを通常のフローの一部として処理します。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)