Hermes API：開発者向け無検閲生成ガイド

Hermes APIとは何ですか？

hermes apiは、主要な商用プロバイダーに典型的なコンテンツフィルタなしで生のテキスト生成を必要とする開発者向けに設計された、無検閲の大規模言語モデルのエンドポイントです。このサービスは汎用LLM APIの専門的な代替手段として機能し、uncensoredとラベル付けされた単一のモデルに焦点を当てています。リクエストをさまざまなベンダーにルーティングするマルチモデルゲートウェイとは異なり、このエンドポイントは専用サーバーでホストされ、成人向け、政治的、または論争的なトピックについて拒否せずに回答するように調整された単一のオープンウェイトモデルを提供します。

主なユースケースは、コンテンツモデレーションがクライアント側で行われるアプリケーションへの統合、またはモデル自体が合法的な大人向けコンテンツをブロックしないことが必要な場合です。APIは厳密にテキスト入力・テキスト出力のみです。埋め込み、画像生成、音声処理は提供されません。大人向けまたは制限のないクリエイティブな文章のための純粋なテキスト生成エンジンを探している開発者にとって、このエンドポイントは既存のコードベースに直接統合するのに適しています。

これは独立したサービスであることに注意することが重要です。GPT、Claude、その他のベンダーモデルは提供していません。モデルは独自のインフラストラクチャ上で動作し、標準的なRESTインターフェースを通じてアクセスされます。hermes apiという名称は、開発者コミュニティの間で、ベースとなるオープンソース版とは区別されるこの特定の無検閲生成能力を指すために口語的にしばしば使用されます。

なぜ無検閲モデルを選ぶのか？

標準的なLLMは、大人向けテーマ、政治的異議、またはニッチな趣味に関連するキーワードやコンテキストでトリガーされる拒否メカニズムを採用することがよくあります。コンテンツプラットフォーム、ロールプレイエンジン、またはクリエイティブな文章ツールを構築する開発者にとって、これらの拒否はユーザー体験を損なう可能性があります。ここで提供されるような無検閲モデルは、コンテンツが違法（未成年者関連など）でない限り、特定の道徳的または安全ガイドラインを強制するよりも、プロンプトに答えることを優先します。

無検閲エンドポイントを選択することで、最終的な出力に対する制御をより細かく行うことができます。403エラーやフィルタリングされた応答なしで、暴力、性的なテーマ、または論争的な歴史的事実をモデルに説明させる必要がある場合、このAPIはその目的のために設計されています。これは、商用プロバイダーが追加する追加の安全レイヤーなしでそれらのベースモデルの動作を望むuncensored llamaおよびuncensored mistralの愛好家に特に役立ちます。

• 一貫性： モデルは曖昧なコンテキストに基づいてランダムに拒否しません。
• 創造の自由：フィクション、エロティカ、またはエッジの効いたユーモアの生成に最適です。
• シンプルさ： 1つのモデル、1つの動作、複雑なルーティングロジックなし。

OpenAI SDKとの互換性

このエンドポイントの最も重要な利点は、OpenAI API仕様への厳格な準拠です。ベースURLとAPIキーを変更するだけで、公式のopenai Python SDK、Node.jsクライアント、またはその他のOpenAI互換ライブラリを使用できます。エンドポイントはPOST /v1/chat/completionsとGET /v1/modelsをサポートしており、標準的なリクエストボディとレスポンス構造がそのまま動作することを保証します。

統合するには、デフォルトのベースURLをhttps://api.openrouternsfw.com/v1に置き換え、APIキーを提供します。リクエストボディで送信するモデルIDはuncensoredです。これは、チャット履歴、システムプロンプト、ユーザーメッセージを処理するための既存のコードに変更が不要であることを意味します。この互換性は、すでにOpenAI JSON構造に精通しているuncensored grokおよびdeepseek apiユーザーにも拡張されます。

エンドポイントはサーバーサイドイベント（SSE）を介したストリーミングレスポンスをサポートしており、生成されるトークンを処理できます。また、関数呼び出し（ツール）、構造化出力用のJSONモード、およびtemperatureやtop_pなどの標準パラメータもサポートしています。これにより、多くの標準的なLLM統合に対してそのまま置き換え可能となります。

設定：温度とTop P

出力のランダム性と創造性の制御は、標準的なパラメータを通じて行われます。temperature値は、次のトークンの確率分布を調整します。低い温度（例：0.2）は出力をより決定論的で焦点を絞ったものにしますが、高い温度（例：0.8）は創造性と多様性を高めます。成人向けコンテンツの生成には、中程度の温度が整合性と多様性の最適なバランスをもたらすことがよくあります。

top_pパラメータは核サンプリングを制御します。これは、累積確率がpを超えるトークンのみをモデルが考慮するように制限します。これはランダム性を制御する別の方法であり、温度と組み合わせて使用されることがよくあります。例えば、top_pが0.95の場合、モデルは最も可能性の高い上位95%のトークンのみを考慮します。

その他のサポートされているパラメータには、stopシーケンス、再現性のためのseed、および反復を抑制するためのpresence_penaltyとfrequency_penaltyが含まれます。これらの設定は、OpenAI互換モデルを使用する場合と同様に、リクエストボディに渡されます。これらの設定を調整することで、特定のスタイルや詳細レベルに合わせてhermes apiの出力を微調整できます。

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

ストリーミングはリアルタイムのユーザー体験に不可欠です。APIはサーバーサイドイベント（SSE）をサポートしており、完全な応答を待つのではなく、生成されるトークンを逐次受信できます。これにより、知覚されるレイテンシが削減され、チャットインターフェースのユーザー体験が向上します。

公式SDKを使用する場合、リクエストでstream=Trueを設定することでストリーミングを有効にします。SDKはデータが到着するたびにチャンクを返します。ストリームの最後のチャンクには、通常、入力および出力トークンの数を含む使用統計が含まれます。これにより、リアルタイムでコストを正確に追跡できます。

SDK以外の実装では、SSEストリームを直接解析できます。各チャンクはdata: で始まり、その後にJSONオブジェクトが続きます。最後のチャンクはdata: [DONE]になります。ストリーミング接続は切断される可能性があるため、クライアントはネットワークの中断を適切に処理してください。hermes apiは、請求のために使用データが最後のチャンクで確実に報告されることを保証します。

トークンの効率性と制限

モデルは、プロンプトと補完の両方を含む100,000トークンのコンテキストウィンドウをサポートしています。これは、ほとんどの長文コンテンツの生成や複雑な推論タスクに十分です。リクエストごとの出力制限はなく、max_tokensを指定しない場合、応答はウィンドウの最後まで実行されます。非常に長い応答が必要な場合は、プロンプトをチャンク化するか、複数の補完をリクエストするロジックを実装する必要がある場合があります。

価格体系は透明で、トークン使用量に基づいています。入力トークンは100万トークンあたり$0.15、出力トークンは100万トークンあたり$0.50です。エラーと拒否（マイナーなコンテンツフィルタ用）は無料のため、成功した生成に対してのみ課金されます。このモデルは、大量のテキスト生成に効率的です。

• コンテキストウィンドウ： 合計100,000トークン。
• 最大出力： 100,000トークンのコンテキストウィンドウの範囲内。
• レート制限： キーあたり1分あたり300リクエスト。
• 同時実行数： キーあたり8つの同時リクエスト。

他のモデルとの比較

hermes apiを評価する際は、他のuncensored llamaやuncensored mistralのオプションと比較すると役立ちます。Ollamaのようなセルフホスト型ソリューションとは異なり、このサービスにはインフラストラクチャ管理が不要です。GPUの設定やモデルウェイトの管理なしで、信頼性の高いエンドポイントが得られます。マルチモデルゲートウェイとは異なり、ルーティングオーバーヘッドなく、一貫した単一の動作を提供します。

GPT-4oやClaudeなどの商用モデルと比較すると、このエンドポイントは大量のテキスト生成に対して大幅に安価であり、コンテンツフィルタを適用しません。ただし、最大規模の独自モデルの推論能力に匹敵するとは限りません。最先端の論理よりもコンテンツの柔軟性が重要なタスクに最も適しています。

deepseek apiユーザーにとって、価格体系は競争力がありますが、モデルアーキテクチャは異なります。hermes apiは無検閲テキスト生成用に最適化されており、汎用AIではなく専門的なツールです。埋め込みや画像生成が必要な場合は、このエンドポイントがテキストのみに対応しているため、別のサービスを使用する必要があります。

コード例で始める

APIの統合は簡単です。GoogleまたはメールでサインアップしてAPIキーを生成する必要があります。キーはすぐに提供されます。次に、ベースURLhttps://api.openrouternsfw.com/v1とモデルIDuncensoredでSDKを設定します。

公式SDKを使用した基本的なPythonの例：

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

Node.jsの例：

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

ストリーミングレスポンスの場合、SDKはSSE解析を自動的に処理します。到着するたびにチャンクをイテレートできます。これにより、アプリケーションでリアルタイムのテキスト表示が可能です。hermes apiは、レスポンス形式がOpenAI標準に一致することを保証するため、標準的なユースケースではカスタム解析ロジックは必要ありません。

その他のガイド

• OpenRouterの無料代替？実際に得られるもの
• Janitor AIでのOpenRouter使い方：プロキシ設定：プロキシ設定
• 無検閲LLM搭載のオープンソースDiscordボット