JA ▾
Base URL https://api.uncensoredaiapis.com/v1モデル uncensored
API キーを取得
Uncensored AI移行ガイド

OpenAI互換APIの使い方:5つのステップ

OpenAI互換のAPIを使うには5つの手順が必要です:APIキーの取得、SDKのインストール、正しいベースURLへの設定、モデル名の指定、メッセージの送信。以下に、そのまま貼り付けて使えるコード付きで各手順を示します。

更新日:

OpenAI互換のAPIを始めるための手順を示す、サーバーキューブへと続く5つの輝く足場

主要ポイント

  • ベースURLを https://api.uncensoredaiapis.com/v1 に変更し、独自のAPI キーを使用すれば、どのOpenAI SDKでも利用可能です。
  • モデルIDは uncensored です。主要なエンドポイントは POST /v1/chat/completions と GET /v1/models です。
  • ストリーミング、JSON モード、関数呼び出しは公式APIと同じパラメータを使用します。
  • 料金は入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50で、$0.50の無料トライアルクレジットから開始できます。

簡易版

OpenAI以外のサービスでopenai API呼び出しを使う方法を知りたい場合、答えはリクエスト形式が共有された規約であることです。この規約に対応するクライアントには3つの値が必要です:リクエストを送る場所(ベースURL)、あなた自身(API キー)、そして実行するモデルです。この3つを変更すれば、同じコードがそのまま使えます。このサイトはその規約に従っているため、標準的なOpenAIのPythonおよびNodeパッケージ、およびcurlでも動作します。

それが何を意味し、何を意味しないのかを明確にしてください。互換性があるとは、インターフェースが一致していることを意味します。これは公式の OpenAI サービスであることや、OpenAI モデルを実行していることを意味するわけではありません。バックエンドは1つのオープンウェイトモデルで、独立したプロバイダによって実行され、法的に許可された成人用途に対してコンテンツ拒否なしで回答するようにチューニングされており、モデル ID uncensored で選択します。テキストのみを処理します:画像、オーディオ、埋め込み、ファインチューニングはありません。

以下の5つのステップには約10分かかります。複数の言語で完成したスニペットを読みたい場合は、コード例ページをご覧ください。

ステップ1:キーの取得

Googleまたはメールアドレスとパスワードでサインアップし、API キーページを開きます。新規ユーザーはワンクリックで$0.50の無料トライアルクレジットを受け取れます。これは7日間有効で、1人1回限り、カード登録は不要です。API キーをコピーして環境変数として保存してください。コードに貼り付けるのではなく、以下のように設定します:

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"

トライアルキーは同時2リクエスト、1分あたり60リクエストに制限されています。チャージ済みのキーでは同時8リクエスト、1分あたり300リクエストが可能です。トライアルに含まれる詳細は無料トライアルFAQをご覧ください。

ステップ2:SDKをインストールし、最初のリクエストを送信する

お使いの言語用の公式パッケージをインストールしてください。これらはOpenAIスタイルのサービスで通常使用するのと同じライブラリです。

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai

Pythonでの最初の呼び出しです。デフォルトの設定との唯一の違いは base_url 引数です。

import os
from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise writing assistant."},
        {"role": "user", "content": "Give me three titles for a noir short story."},
    ],
)
print(resp.choices[0].message.content)

Nodeでの同じ呼び出し:

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);

ステップ3:messages配列を理解する

チャットモデルは呼び出し間で記憶を保持しません。各リクエストには会話全体がメッセージのリストとして含まれ、各メッセージにはロールが設定されます。

  • system は動作やスタイルを設定します。ペルソナ、フォーマットルール、制約をここに記述します。
  • user にはユーザーの入力内容が含まれます。
  • assistant にはモデルの以前の応答が含まれます。会話を継続する場合は自分で追加します。
  • tool には関数呼び出しの結果が含まれます(後述)。

チャットを続行するには、アシスタントの返信と次のユーザーメッセージを同じリストに追加し、すべてを再度送信します。これが長文の会話ほどコストがかかる理由です。すべての呼び出しで、履歴全体が入力トークンとして処理されます。ウィンドウはプロンプトと生成トークンを合わせて合計 100,000 トークンまで保持するため、古い会話を削ることはチャットアプリを構築する際の通常の部分です。

有用なサンプリングフィールドはそのまま渡されます:temperature、top_p、stop、seed、および頻度ペナルティと存在ペナルティです。max_tokensはオプションです。返信の長さとコストを制限したい場合に設定してください。

ステップ4:ストリーミング、JSONモード、ツール

ストリーミング

stream: trueを追加して、サーバー送信イベントとしてトークンを受け取ります。これにより、モデルがまだ応答を生成している間にテキストが表示されるため、インターフェースが高速に感じられます。また、ストリームの終了時に使用量が報告されます。

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
  stream: true,
});

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

JSON モード

コードで応答を解析する場合は、response_format: {"type": "json_object"}を使用してください。プロンプトでも指定したいキーを説明してください。

curl https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
      {"role": "user", "content": "Rate this line: the rain finally stopped."}
    ]
  }'

関数呼び出し

関数スキーマを含むtoolsリストと、オプションでtool_choiceを渡します。モデルが関数の実行を必要とする場合、応答にはtool_callsが含まれます。関数を自分のコードで実行し、出力をrole toolのメッセージとして送信します。ツール呼び出しもストリーミングされます。これはエージェントの構築ブロックであり、ユースケースページでそのメリットを確認できます。

ステップ5:制限、コスト、エラーの理解

制限を超えると、API は HTTP 429 を返します。エラーコードは、1分あたりのリクエスト数超過の場合 rate_limited、同時実行数超過の場合 concurrency です。一時的な過負荷でも 429 が返され、Retry-After: 5 ヘッダーが含まれます。ストリーミングリクエストはストリームが終了するまで同時実行枠を保持するため、読み込みが不要なストリームは閉じてください。ボディの制限は 8 MB です。すべての応答には X-Request-Id および X-Balance-USD ヘッダーが含まれており、前者はサポート時に引用するものです。

コストはシンプルです。入力トークン3,000、出力トークン700のチャット呼び出しのコストは、3,000 × 100万トークンあたり$0.15で$0.00045、700 × 100万トークンあたり$0.50で$0.00035となり、合計$0.0008です。このような呼び出し1,000回で$0.80です。失敗または拒否されたリクエストは課金されず、クレジットは期限切れになりません。料金ページには、$20〜$500のチャージ一覧が記載されており、$50以上で+5%、$100以上で+10%、$200以上で+15%のボーナスが付きます。暗号資産(TRC20上のUSDT、Base上のUSDC)で支払えます。

公式APIとの違い

計画すべき3つの違いがあります。第一に、モデル名:OpenAIのモデル名ではなく、uncensoredを使用してください。第二に、スコープ:チャット補完とモデルリストのみが提供されるため、画像生成、音声、埋め込み、ファインチューニングなどの機能はありません。第三に、動作:このモデルは法的な成人リクエストを拒否しないようにチューニングされているため、出力は強くフィルタリングされたアシスタントとは異なる場合があります。1つのルールは常に変わりません:未成年者を含む性的コンテンツは禁止です。

初日に役立つ習慣をいくつか紹介します。API キーを環境変数に保持し、すべての呼び出しの X-Request-Id をログに記録し、実験中は max_tokens を設定して、応答が暴走して計画した予算を超えないようにしてください。チャットインターフェースを構築する場合は、履歴が長くなったらストリーミングで応答を取得し、古い会話を削ってください。出力を解析するパイプラインを構築する場合は、JSON モードを使用し、応答をガードしてください。トークン制限で応答が切れた場合、それは有効な JSON ではないからです。プログラムの2つの部分が同時に API を呼び出す場合、フルキーが許可する8つの同時リクエスト枠をカウントしてください。

テストのコストを忘れないでください。短いプロンプトでの数十回の実験は、合計で1セント未満のコストで済むため、$0.50の無料トライアルクレジットはリクエスト形式を学ぶ間、十分に役立ちます。

既存のアプリを移行する場合は、移行ガイド が変更点を順を追って説明しています。ここで送信されるプロンプトはトレーニングには使用されません。ほとんどのアプリにとって移行は、このページの冒頭にある3つの値とモデル名だけです。

質問と回答

公式のOpenAI SDKが必要ですか?

利用できます。また、カスタムベースURLをサポートしている限り、他のOpenAI互換クライアントやプレーンHTTPも使用可能です。

どのモデル名を送信すればよいですか?

uncensored を送信します。ベースURLは https://api.uncensoredaiapis.com/v1 です。

これは公式のOpenAI APIですか?

いいえ。同じリクエスト形式に従いますが、モデルは独立したプロバイダが運用するオープンウェイトモデルであり、サービスはOpenAIとは別物です。

リクエストの料金は?

入力トークンは 1M あたり $0.15、出力トークンは 1M あたり $0.50 かかります。入力 3,000 トークン、出力 700 トークンのリクエストは約 $0.0008 かかります。

支払い前に試すことはできますか?

はい。サインアップ後、ワンクリックで$0.50の試用クレジットを請求できます。これは7日間有効で、カードは不要です。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。