JA ▾
API キーを取得

無検閲 AI API 初回呼び出しと OpenAI SDK 接続

無検閲AI APIを初めてご利用の場合、必要なのはAPIキー一つとbase URLの変更だけです。すでにOpenAI SDKで記述したコードがある場合、URLとモデル名を変更するだけで最初の応答を受け取ることができます。

更新日

OpenAI 互換コネクタが API ゲートウェイに接続され、データが流れるアイソメトリックイラスト

コアサマリー

  • base URLはhttps://api.mugeomyeolapi.com/v1、モデルIDはuncensoredです。
  • chat/completions、responses、models エンドポイントと、ストリーミング、ツール呼び出し、JSON モードをサポートしています。
  • 429 エラーは rate_limited と concurrency の 2 種類に分かれ、原因に応じて対応が異なります。
  • テキスト専用であり、未成年者が関与する性的コンテンツはいかなる場合でも許可されません。

開始前の準備

必要なものは 3 つだけです。キー、base URL、モデル ID です。その他は通常使用する OpenAI 互換クライアントが処理します。

  1. 登録します。Google アカウント、またはメールアドレスとパスワードで登録できます。
  2. API キー発行ページでキーを作成してください。新規ユーザーは、このページでボタンを 1 回クリックするだけで $0.50 の無料トライアルクレジットを受け取ることができます。1 人 1 回、有効期限は 7 日で、決済情報は不要です。
  3. base URL に https://api.mugeomyeolapi.com/v1を、モデルに uncensoredを指定します。

認証は標準的な Authorization: Bearer <キー> ヘッダーを使用します。キーはコードに直接記載せず、環境変数に格納してください。以下の例ではすべて MUGEOMYEOL_API_KEYという変数を読み取ります。

Pythonで最初の呼び出しを行う

openai パッケージ (v1 以降) をインストールし、クライアント作成時に base_urlのみを変更してください。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mugeomyeolapi.com/v1",
    api_key=os.environ["MUGEOMYEOL_API_KEY"],
)

res = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "당신은 간결하게 답하는 한국어 어시스턴트입니다."},
        {"role": "user", "content": "HTTP 429 오류가 무엇인지 두 문장으로 설명해 줘."},
    ],
    temperature=0.7,
)
print(res.choices[0].message.content)
print(res.usage)

応答の usageには入力と出力のトークン数が含まれています。料金はこの数字に基づいて計算されます。残高は応答ヘッダー X-Balance-USDで直接確認できます。Python SDK では with_raw_responseを使用するとヘッダーにアクセスできます。

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])
raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "안녕"}],
)
print("잔액(USD):", raw.headers.get("X-Balance-USD"))
completion = raw.parse()
print(completion.choices[0].message.content)

curl と Node.js の例

SDKなしで確認だけしたい場合は、curlが最も高速です。キーが正常に動作しているか確認する際に役立ちます。

curl https://api.mugeomyeolapi.com/v1/chat/completions \
  -H "Authorization: Bearer $MUGEOMYEOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "한 줄로 자기소개해 줘."}]
  }'

Node.js でも構造は同じです。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mugeomyeolapi.com/v1",
  apiKey: process.env.MUGEOMYEOL_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "짧은 시를 한 편 써 줘." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

ストリーミングはstream: true一つで有効になり、SSEで配信されます。使用量はストリームの終了時に確認できます。利用可能なモデル一覧はGET /v1/modelsで取得します。本サービスはモデルがuncensored一つのみであるため、一覧も短くなります。

よく使うパラメータ

OpenAI Chat Completions で使用していたパラメータのほとんどがそのまま有効です。よく使うものだけをまとめると以下の通りです。

パラメータ用途
temperature, top_p回答のランダム性を調整します。両方を同時に大きく変更するよりも、どちらか一方のみを調整した方が結果の予測が容易です。
stop、seed終了文字列の指定、再現性の確保
存在/頻度ペナルティ繰り返し抑制
max_tokensオプション。省略するとコンテキストウィンドウの残りすべてを使用できます。
tools, tool_choiceツール呼び出し。結果は role: "tool" メッセージとして返します。
response_format{"type":"json_object"}で JSON モードを有効にします。

コンテキストウィンドウはプロンプトと出力を合わせて100,000トークンです。長いドキュメントを入力する際は、入力がこの上限の大部分を占めないようにしてください。JSON モードを使用する際は、プロンプトにもJSONで回答するよう指示しておくと安定します。

import os, json
from openai import OpenAI

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])

res = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "도시 3곳의 이름과 인구 규모 느낌을 JSON 객체로 줘. 키는 cities 하나."}],
)
data = json.loads(res.choices[0].message.content)
print(data)

エンドポイントにはPOST /v1/chat/completionsのほかにPOST /v1/responsesもあります。新しいコードでResponses形式を使用している場合は、同じbase URLで呼び出すことができます。詳細なフィールドはAPIドキュメントで確認してください。

エラーコードとリトライ処理

最初に遭遇するエラーはHTTP 429です。このサービスでは、このエラーには2つの意味があります。

  • rate_limited: 1分あたりのリクエスト数を超えました。正規キーは1分あたり300件、体験キーは1分あたり60件です。
  • concurrency: 同時に処理中のリクエストが多すぎます。正規キーは8件まで、体験キーは2件までです。

サーバーが一時的に混雑している場合も429エラーが発生し、この場合はRetry-After: 5ヘッダーが付きます。5秒後に再送してください。ストリーミングリクエストは、ストリームが終了するまで同時処理スロットを1つ占有することに注意してください。ストリームを開いたまま閉じないと、同時接続数にすぐに達します。

import os, time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"], max_retries=0)

def ask(prompt, tries=5):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))  # 5초, 10초, 15초 ... 점점 늘려 기다림
    raise RuntimeError("재시도 한도를 넘었습니다")

print(ask("테스트 메시지"))

同時リクエストが問題となる場合は、リトライよりも呼び出し側でセマフォを使って同時実行数を制限する方が望ましいです。レスポンスヘッダーX-RateLimit-Limit-RequestsとX-RateLimit-Limit-Concurrencyで現在のキーの上限を確認できます。リクエスト本文の最大サイズは8MBです。失敗または拒否されたリクエストには料金が請求されません。問題について問い合わせる際は、レスポンスヘッダーのX-Request-Idを一緒に渡すと、サポートページで原因を特定しやすくなります。

利用規約と知っておくべき制限

このサービスは合法な成人利用を前提とし、コンテンツのフィルタリングなしで回答するように調整されたオープンウェイトモデルを、独立した事業者が運用するAPIです。Meta、Mistral、Qwen、DeepSeek、OpenAI、xAI、Google、Anthropicなどの公式APIではなく、複数の企業のモデルにリクエストを分散させるルーティングサービスでもありません。無検閲AI APIを選択する際は、この違いを理解し、ドキュメントと実際の動作を混同しないようにしてください。

  • 未成年者が関わる性的コンテンツは、いかなる場合でも許可されません。この制限は緩和されません。
  • テキスト専用です。画像、音声、動画の生成、埋め込み、ファインチューニングは提供しません。
  • 入力したプロンプトはモデルの学習には使用されません。詳細はプライバシーポリシーをご参照ください。

回答にフィルタリングがないことは、責任がないことを意味するわけではありません。サービス提供者は利用規約と関連法令を遵守する必要があります。

コスト感覚とチャージ

料金は入力100万トークンあたり$0.15、出力100万トークンあたり$0.50で、前払いクレジットから差し引かれます。サブスクリプションはなく、クレジットは期限切れになりません。例えば、入力2,000トークン、出力500トークンのリクエスト1件は、入力$0.0003と出力$0.00025を合計して$0.00055となります。1,000件送信しても$0.55です。

体験クレジット$0.50で、上記規模のリクエストを約900件試すことができます。チャージは$20から$500まで整数金額で可能で、$50以上で5%、$100以上で10%、$200以上で15%のボーナスが付きます。決済手段はUSDT(TRC20)とUSDC(Base)です。詳細な料率表は料金ページにあります。

その他のガイド

よくある質問

OpenAI SDKのコードをどのくらい変更する必要がありますか?

base URL、APIキー、モデル名の3つだけを変更すれば大丈夫です。モデルIDはuncensored、base URLはhttps://api.mugeomyeolapi.com/v1です。

体験クレジットはどうやって受け取りますか?

登録後、API キーページでボタンを1回クリックするだけで$0.50が付与されます。1人1回、有効期限7日で、決済情報は不要です。

429エラーが発生しますが、どうすればよいですか?

まず、エラーコードがrate_limitedかconcurrencyかを確認してください。前者は1分あたりのリクエスト数超過、後者は同時リクエスト数超過です。Retry-Afterヘッダーがある場合は、その時間だけ待ってから再試行します。

画像も生成できますか?

いいえ。このAPIはテキスト専用であり、画像、音声、動画の生成や埋め込みには対応していません。

長いドキュメントも一度に読み込めますか?

プロンプトと出力を合わせて100,000トークンまで使用できます。リクエスト本文のサイズは最大8MBです。

API キーは登録だけで

アカウント作成、キーのコピー、ベースURLの変更。設定はこれで完了です。

API キーを取得する
API キーを取得する