Mukenetsu AI API クイックスタート
Mukenetsu AI APIは、OpenAI互換の標準エンドポイントを持つ検閲なしLLMサービスです。Base URLの変更とAPIキーの設定だけで、既存のSDKやクライアントに即座に統合し、コンテンツ制限なくテキストを生成できます。
- ベースURL
https://api.mukenetsuapi.com/v1- モデル
uncensored
基本設定とベースURL
Mukenetsu AIは、OpenAI互換のREST APIとして設計されています。これにより、既存のOpenAIクライアントやSDKをわずかな変更だけで使用できます。APIとの通信には、以下のベースURLを使用します。
https://api.mukenetsuapi.com/v1
他のLLMサービスとは異なり、複雑なエンドポイントの選定や追加の設定は不要です。単一のチャット補完エンドポイントとモデル一覧エンドポイントのみが提供されます。このシンプルな構造により、開発は迅速に進みます。
APIキーは、Get API keyページでメールアドレスとパスワードを使って登録する際に、サインアップ直後に即座に取得できます。ダッシュボードの操作は不要です。また、プライバシーを重視し、プロンプトデータはモデル学習用に使用されません。
認証とAPIキー
APIへのアクセスには、ヘッダーAuthorization: Bearer <API_KEY>による認証が必要です。Mukenetsu AIのAPIキーは、アカウント作成時に生成されたものを使用します。一つのアカウントにつき一つのAPIキーが割り当てられますが、必要に応じていつでも再生成できます。キーを再生成すると、それ以前のキーは無効化されるため、注意してください。
認証エラーが発生した場合、通常は401(Unauthorized)または402(Payment Required)レスポンスが返されます。401はキーが間違っているか無効化されたことを示し、402はアカウントのクレジット残高が不足していることを意味します。クレジットは前払い式で、暗号資産(USDT・USDC)で$20以上からチャージできます。
チャット補完エンドポイント
テキスト生成の主要なエンドポイントはPOST /v1/chat/completionsです。このエンドポイントにリクエストを送信することで、会話履歴やシステムプロンプトを含めてテキストを生成できます。モデルIDとしてuncensoredを指定してください。これは、OpenAIのGPTや他のベンダーのモデルとは異なる、独自のオープンウェイトモデルです。
以下の例は、curlを使用して基本的なテキスト生成を行う方法を示しています。必要なパラメータはモデルID、メッセージ、そしてオプションでストリーミングの有効化です。
curl https://api.mukenetsuapi.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."}]
}'このエンドポイントでは、埋め込み(embeddings)や画像生成、音声変換などの機能は提供されません。純粋なテキストの補完と生成に特化しています。
ストリーミング(SSE)
生成されたテキストをリアルタイムで取得したい場合、ストリーミングモードを使用できます。リクエストに"stream": trueを含めると、サーバーはサーバー送信イベント(SSE)形式でデータを逐次返します。これにより、ユーザーは生成が完了する前にテキストの一部を表示できます。
PythonのOpenAI SDKやNode.jsのクライアントライブラリを使用している場合、stream=Trueオプションを指定するだけで自動的にストリーミング処理が行われます。イベントハンドラは、トークンごとのチャンクを受け取ります。
from openai import OpenAI
client = OpenAI(base_url="https://api.mukenetsuapi.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)ストリーミングは、長い応答や対話型アプリケーションにおいて、ユーザーエクスペリエンスを向上させるための重要な機能です。ただし、ストリーミング中に接続が切断された場合、以降のイベントは受信できなくなります。
ツール/関数呼び出し
Mukenetsu AI APIは、ツール(関数)呼び出しをサポートしています。これにより、外部のAPIやデータベースとの連携が容易になります。リクエストボディにtoolsフィールドとtool_choiceパラメータを含めることで、モデルに特定の関数を実行させることができます。
モデルは、必要に応じて関数を呼び出すか、通常のテキストを返すかを判断します。呼び出しが完了すると、関数の結果をmessagesに追加してモデルに渡すことで、さらに詳細な回答を得ることができます。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mukenetsuapi.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);この機能は、エージェント型アプリケーションや複雑なタスクの自動化に特に有用です。OpenAI互換の形式を採用しているため、既存のツール呼び出しのロジックをそのまま流用できます。
レートリミットと制約
APIの利用には、以下の制限があります。1分間に最大300リクエスト、リクエストボディの最大サイズは8MBです。これらを超えると429(Too Many Requests)エラーが返されます。また、コンテキストウィンドウは100,000トークン(プロンプト+生成テキストの合計)です。これを超える長い会話や文書は、適切に分割して送信する必要があります。
ストリーミングレスポンスを受信する際は、以下のイベントフローに従います。
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 仕様
購入前に確認できるよう、API の実際の制限と機能をすべてまとめました。
| 項目 | 内容 |
|---|---|
| 形式 | OpenAI 互換:どの OpenAI SDK でも base URL とキーを変えるだけで動作 |
| モデル ID | uncensored |
| エンドポイント | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.mukenetsuapi.com/v1 |
| 認証 | Authorization: Bearer YOUR_KEY |
| ストリーミング | 対応 — SSE、最後のチャンクにトークン使用量 |
| パラメータ | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON モード | response_format: {"type": "json_object"} |
| コンテキスト長 | 100,000 トークン(入力+出力) |
| 最大出力 | 100,000 トークンのウィンドウの残りまで。max_tokens は任意(個別の上限なし) |
| 関数呼び出し | 対応 — tools、tool_choice。応答に tool_calls(ストリーミングでも)、結果は role: tool で返送 |
| リクエストサイズ | 最大 8 MB |
| 同時実行 | キーごとに同時 8 リクエストまで |
| レスポンスヘッダー | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| レート制限 | キーごとに毎分 300 リクエスト |
| 無料トライアル | $0.50、7 日間、カード不要 · トライアルキー: 同時2件、毎分60件。初回チャージ後に上限が8件・300件へ拡大 |
| 課金 | 前払いクレジットから実使用量で課金。エラーと拒否は無料 |
| 有効期限 | 購入クレジットは失効なし、サブスクなし |
| チャージ | USDT(TRC20)または USDC(Base)、$20〜$500 の任意の整数額 |
| ボーナス | $50 以上で +5%、$100 以上で +10%、$200 以上で +15% |
| 料金 | 入力 100 万トークン $0.15 · 出力 100 万トークン $0.50 |
| コンテンツ | 成人向けコンテンツ可。未成年者を含む性的コンテンツは拒否 |
| ログイン | Google またはメール+パスワード |
| キー | アカウントごとに有効なキーは 1 つ。新しいキーで旧キーは無効 |
エラーコード
エラーは固定の type を持つ JSON で返ります。失敗・拒否されたリクエストは課金されません。
| コード | タイプ | 意味 |
|---|---|---|
400 | bad_request | JSON 不正、メッセージ空、パラメータ誤り、またはコンテキスト超過 |
401 | missing_key · invalid_key · key_revoked | キーなし・誤り・新しいキーに置換済み |
402 | no_credit | 残高ゼロ — チャージすれば即再開 |
403 | content_blocked | 未成年者を含む性的コンテンツ — 拒否、課金なし |
404 | not_found | 不明なエンドポイント |
413 | request_too_large | 本文が 8 MB 超 |
429 | rate_limited · concurrency | 毎分 300 回または同時 8 件を超過 — 待って再試行 |
503 | upstream_busy | モデル混雑 — 数秒後に再試行 |
よくある質問
APIキーはどこで取得できますか?
APIキーは、サイトの「Get API key」ページでメールアドレスとパスワードを使ってサインアップする際に、直ちに取得できます。ダッシュボードの操作は不要で、キーはサインアップ直後に画面に表示されます。
どのモデルが使用されていますか?
モデルID「uncensored」で、独自のオープンウェイトモデルが使用されています。これはGPT、Claude、Geminiなどの他社モデルとは異なり、当社のGPUサーバー上で動作しています。モデルの詳細なアーキテクチャやベンチマークスコアは現在公開されていません。
ストリーミング中にエラーが発生した場合、どうなりますか?
ストリーミング中に接続が切断されると、それ以降のイベントは受信できなくなります。必要な場合は、切断された位置からリクエストを再送するか、通常の(ストリーミングではない)リクエストを送信して完全なレスポンスを取得してください。
APIキーはフォーム1つで入手可能
アカウント作成、キーのコピー、ベースURLの変更。これだけですべて設定完了です。