OpenRouter NSFWユーザー向けクイックスタート

ベースURLと認証

現在のプロバイダーのベースURLを https://api.openrouternsfw.com/v1 に置き換えます。認証は標準の Authorization: Bearer <key> ヘッダーを使用します。Googleまたはメールで登録するとすぐに、APIキーを取得 ページでキーを取得できます。電話番号は必要なく、キーは1回だけ表示されるため、ページを離れる前にコピーしてください。

当社のサービスは独立したAPIであり、他のベンダーのモデルを再販売するものではありません。リクエストで送信するモデル識別子は uncensored で、当社のサーバー上で実行されます。法的な成人用途のためにコンテンツ拒否なしで回答するようにチューニングされていますが、GPT、Claude、またはその他の特定のベンダーモデルではありません。

クライアントライブラリが新しいベースURLを使用するように構成されていることを確認してください。すべてのリクエストには、有効なAPIキーをヘッダーに含める必要があります。キーがない場合または無効な場合、サーバーは401エラーを返します。前払いクレジットがない場合、402エラーが発生します。これらは認証または支払いの問題を示す標準的なHTTPステータスコードであり、サーバーエラーではありません。

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

コア機能は POST /v1/chat/completions エンドポイントを通じて提供されます。このエンドポイントは、モデル名、メッセージ配列、およびオプションのパラメータを含むJSONボディを受け付けます。生成されたテキスト、トークン使用統計、終了理由を含むJSONオブジェクトを返します。この構造は、公式のOpenAI SDKおよびほとんどのOpenAI互換クライアントライブラリと互換性があります。

SDKの使用を好む場合、カスタムHTTPクライアントを記述する必要はありません。ただし、ベースURLを指すように構成を更新する必要があります。次の例は、cURLを使用した標準的な完了リクエストを示しています。このリクエストは、無検閲モデルにプロンプトを送信し、テキスト応答を期待します。

コピーcurl https://api.openrouternsfw.com/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."}]
  }'

このAPIはテキストのみを提供することに注意してください。埋め込み、画像、音声、または動画生成のエンドポイントはありません。アプリケーションが多モーダルな入出力を必要とする場合、それらを個別に処理する必要があります。当社のサービスは、無検閲モデルを使用した高品質なテキスト生成に専念しています。

Python SDK統合

Python SDKを使用すると、統合プロセスが簡素化されます。正しいベースURLとAPIキーを使用してクライアントを初期化します。ライブラリはHTTPリクエストとJSON解析を処理します。特定のモデルを使用していることを確認するために、モデルIDを uncensored として指定できます。

コピーfrom openai import OpenAI

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

このコードスニペットは、メッセージを送信して応答を取得する方法を示しています。クライアントは接続とエラーレポートを自動的に処理します。サーバーがエラーを返した場合、SDKは例外を発生させます。これらの例外をアプリケーションロジックで処理して、より良いユーザーエクスペリエンスを提供してください。

Python SDKは選択肢の一つに過ぎません。HTTPリクエストをサポートする任意の言語を使用できます。エンドポイントの構造は選択したクライアントに関係なく同じです。この柔軟性により、大幅なコード変更なしに既存のワークフローに無検閲モデルを統合できます。

Node SDKの使用

Node SDKはPython版と同様に動作します。ベースURLとAPIキーでクライアントを構成し、チャット完了メソッドを呼び出します。このアプローチは、非同期でテキストを生成する必要があるサーバーサイドアプリケーションやバックエンドサービスに最適です。

コピーimport OpenAI from "openai";

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

Node.js開発者は、このAPIを既存のプロジェクトに簡単に統合できます。SDKはJSONデータのシリアライズとデシリアライズを処理します。また、出力のランダム性を制御するために temperature や top_p などの追加パラメータを指定することもできます。

リクエストの非同期性を適切に処理してください。async/await またはPromiseチェーンを使用して応答データを管理します。これにより、モデルがテキストを生成する待機中にアプリケーションが応答性を維持します。Node SDKは、スケーラブルなテキスト生成サービス構築のための信頼性の高い選択肢です。

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

リクエストで stream パラメータを true に設定してストリーミングを有効にします。サーバーは単一のJSON応答の代わりに、一連のサーバー送信イベント（SSE）を送信します。各イベントには、生成されたテキストの部分的なチャンクが含まれています。

コピーstream = 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)

ストリーミングは、生成される出力を表示したいリアルタイムアプリケーションに役立ちます。ストリームの最終チャンクには、リクエストの合計トークン使用量が含まれています。これにより、応答が完了するのを待たずにコストを正確に追跡できます。

テキストが正しく組み立てられるように、ストリームイベントを慎重に処理してください。受信した順序でチャンクを連結します。サーバーはチャンクが順序通りに送信されることを保証します。接続が切断された場合、リクエストを再試行する必要がある場合があります。ストリーミングは、テキスト生成タスクのユーザーエクスペリエンスを向上させる強力な機能です。

レート制限とコンテキストウィンドウ

各APIキーは1分あたり300リクエストと8つの同時リクエストに制限されています。リクエストボディのサイズは8 MBに制限されます。これらの制限を超えると、サーバーは429ステータスコードを返します。これは、指定された時間枠内で送信されたリクエストが多すぎことを示す標準的なHTTPステータスコードです。これらのエラーを適切に処理するために、クライアントに指数関数的バックオフを実装してください。

コンテキストウィンドウは、結合されたプロンプトと完了に対して最大100,000トークンをサポートします。出力の上限は個別に設けられていません。max_tokens パラメータを指定しない場合、応答はウィンドウの最後まで実行されます。max_tokens を低い値に設定することで、出力長を制限できます。

トークン使用状況を監視して、前払いクレジットを効果的に管理してください。エラーと拒否はトークンを消費しないため、失敗したリクエストに対しては課金されません。これにより、成功したテキスト生成に対してのみ課金されます。サービスの中断を避けるためにレート制限に注意してください。