JA ▾

MiniMax API 設定:キー、ベースURL、最初のリクエスト

これは minimaxapikey.com 上の OpenAI 互換 API のステップバイステップのセットアップです:アカウント、キー、ベースURL、最初のリクエスト。これは独立したサービスであり、任意のモデルベンダーの公式 API ではありません。

更新

キーからサーバーラックへと続く6つの輝かしいステップは、API 設定の経路を表しています

主なポイント

  • Google またはメールでサインアップし、キーページで $0.50 の無料トライアルクレジットを獲得します。カードは必要ありません。
  • Base URLはhttps://api.minimaxapikey.com/v1 、モデルIDはuncensored、認証はBearerキーです。
  • 2つのメソッドが存在します:POST /v1/chat/completions と GET /v1/models
  • 401 はキーが間違っていることを意味し、429 は制限に達したことを意味します。本文のエラーコードを確認してください。

セットアップ内容

人々は minimax api setup を検索し、2つのもののいずれかを期待しています:公式の MiniMax 開発者プラットフォームか、そのまま置き換え可能な OpenAI 風エンドポイントです。このページは後者を扱います。minimaxapikey.com の背後にあるサービスは、独立したプロバイダが運用する、単一のオープンウェイトモデルを実行するホスティングされた OpenAI 互換テキスト API です。MiniMax または他の任意のモデルベンダーの公式 API ではなく、ベンダー間でリクエストをルーティングするものではありません。ベンダー自身のプラットフォームが必要な場合は、そのサイトを使用してください。

得られるものはシンプルです。ベースURLとAPI キーを変更するだけで、任意のOpenAI SDKまたはクライアントが動作します。2つのメソッド、POST /v1/chat/completionsとGET /v1/models、1つのモデルID、uncensored、およびプロンプトとcompletionで共有される100,000トークンのコンテキストウィンドウがあります。テキストのみを処理するため、画像、音声、動画の生成、埋め込み、ファインチューニングはありません。ストリーミング、ツール呼び出し、JSON モードがサポートされています。

全体のセットアップには数分かかります。以下の手順は順序通りに行い、各ステップは完了確認で終わるため、次に進む前に成功したことがわかります。

ステップ 1 と 2:アカウントの作成とトライアルの獲得

  1. キーページを開く。 API キーページ にアクセスしてサインアップします。Google またはメールアドレスとパスワードを使用できます。
  2. トライアルクレジットを獲得する。 サインアップ後、キーページに $0.50 の無料トライアルクレジット用のボタンがあります。ワンクリックでカード不要、7日間有効、1人あたり1回限りの制限があります。

トライアルが小さいのは意図的です。1M 入力トークンあたり $0.15、1M 出力トークンあたり $0.50 の場合、$0.50 は十分な数のテストリクエストをカバーできます。1,000 トークンのプロンプトと 500 トークンの回答の場合、入力は $0.00015、出力は $0.00025 かかり、合計 $0.0004 です。$0.50 をこの金額で割ると 1,250 回のリクエストが可能になるため、実験するには十分な余地があります。

トライアルキーの制限に注意してください:同時リクエストは 2、1分あたりのリクエストは 60 です。チャージ後に取得するフルキーでは、同時リクエストは 8、1分あたりのリクエストは 300 が許可されます。テストループが並列で実行され、429 エラーが表示される場合は、これが最初に確認すべき点です。

ステップ 3:キーの作成と安全な保管

同じページで API キーを作成し、コピーします。パスワードのように扱ってください。環境変数またはシークレットマネージャーに格納し、リポジトリ、フロントエンドバンドル、スクリーンショットには決して入れないでください。キーが漏洩した場合は、削除して新しいキーを作成してください。

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

サーバー側のコードはランタイムで変数を読み取るべきです。ブラウザのコードはキーを保持すべきではありません。ブラウザに配信されるものはすべての訪問者に見えるため、バックエンドからリクエストを送信してください。

ステップ 4:モデルのリストでキーを確認する

最も安価なテストはモデルエンドポイントです。テキストを生成しないため、キー、URL、ネットワークのクリーンなチェックになります。

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

uncensored を含む JSON リストが返されるはずです。401 が返される場合は、キーが間違っているか、余分なスペースや引用符が含まれています。接続が失敗する場合は、URL が /v1 で終わっていること、および https を使用したことを確認してください。

ステップ 5:最初のチャットリクエストを送信する

実際の completion です。ボディは標準的な chat completions の形式です。

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

応答には choices[0].message.content と、プロンプトおよび completion のトークン数を含む usage ブロックが含まれます。curl -i で応答ヘッダーも確認してください。サポートがリクエストを検索するために使用できる X-Request-Id、残りのクレジットを示す X-Balance-USD、およびレート制限ヘッダー X-RateLimit-Limit-Requests と X-RateLimit-Limit-Concurrency が表示されます。

temperature、top_p、stop、seedなどのパラメータやペナルティはそのまま渡されます。max_tokensはオプションです。指定しない場合、completionはウィンドウの残りをすべて使用できます。

ステップ 6:SDK からの同じ呼び出し

curl が動作したら、実際に使用する言語に移動します。標準的な OpenAI 設定から変更される引数は2つだけです。

from openai import OpenAI
import os

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

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

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

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

ストリーミングの場合、stream: true を追加し、サーバー送信イベントを読み取ります。使用量はストリームの最後に届きます。ドキュメントページ では、ストリーミング、ツール呼び出し、response_format: {"type":"json_object"} を使用した JSON モードについて説明しています。

既存の OpenAI プロジェクトの移行

接続したいプロジェクトのほとんどは、すでに OpenAI のクライアントライブラリで動作しています。その場合、コードをほとんど編集する必要はありません。公式 SDK は引数を渡さない場合、環境変数 OPENAI_API_KEY と OPENAI_BASE_URL を読み取るため、デプロイメントの変更だけで十分です。

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

残りの1つの編集はモデル名です。OpenAI のモデル ID などの文字列はここには存在しないため、設定値経由で切り替えられるようにして、uncensored に置き換えます。次に、サービスが提供していない機能についてコードを読み直してください。画像生成、音声、埋め込み、ファインチューニングは利用できません。これはテキストのみ対応のチャット API であるためです。アプリが検索のために埋め込みを呼び出す場合、その部分には別のプロバイダが必要になり、チャットはこのまま維持できます。

モデルの性質を知っておくことも役立ちます。これは単一のオープンウェイトモデルで、合法的な成人向け利用のためにコンテンツ拒否なしで回答するようチューニングされており、設定に関係なく1つの厳格な制限があります:未成年者を含む性的コンテンツは禁止です。他のモデル用に書かれたプロンプトは、同じシステムプロンプトに対して各モデルが異なる反応を示すため、小さな調整が必要になる場合があります。実際のトラフィックを切り替える前に、独自のテストプロンプトを並べて実行してください。

初日に選択すべき設定

いくつかの決定は、ローンチ後よりもセットアップ時に下す方が簡単です。どれも難しくはありませんが、それぞれが後の予期せぬ事態を防ぎます。

  • システムプロンプト。 トーン、フォーマット、ロールに関する指示を system メッセージに含めてください。すべてのリクエストが入力トークンとしてこれを繰り返すため、短く具体的に保ってください。
  • トークン上限 max_tokensは任意ですが、上限は低コストの安全策です。なしだと1つの応答で100,000トークンのウィンドウの残りを使用する可能性があります。
  • インタラクティブな用途のためのストリーミング。 人が返信を待っている場合は、stream: true を設定してください。バッチジョブの場合、通常のリクエストの方がシンプルです。
  • 429 のためのリトライルール。 429 を失敗ではなく待機シグナルとして扱ってください。レスポンスに Retry-After: 5 が含まれている場合、その時間だけ待機して再試行するのが正しい対応です。
  • リクエストサイズ。 本文の制限は 8 MB です。通常のプロンプトに必要な量をはるかに超えますが、貼り付けたログやドキュメントではこれに達する場合があります。

プロンプトはトレーニングに使用されないため、内部ドキュメントやユーザーメッセージを送信する予定の場合は重要です。送信する内容に対してはあなたが責任を負うため、モデルに必要のないシークレットをプロンプトに入れないでください。

トライアル後のチャージ

トライアルはすべてが正常に動作することを確認するためのものです。構築の準備ができたら、前払いクレジットを追加してください。サブスクリプションはありません:使用したトークンに対して課金され、入力トークン 100 万トークンあたり $0.15、出力トークン 100 万トークンあたり $0.50 で、クレジットは期限切れにならないため、未使用の残高は月末に消失しません。

$20 から $500 の任意の整数額が有効です。$50 のチャージでは 5% のボーナス、$100 では 10%、$200 では 15% が付与されます。簡単な例として、10% のボーナス付きの $100 チャージでは $110 のクレジットが得られます。ステップ2の 1,000 トークンのプロンプトと 500 トークンの回答の場合、1リクエストあたり $0.0004 かかるため、$110 で 275,000 回のリクエストをカバーできます。実際のプロンプトは通常長いため、この数字を自分の平均値に合わせて調整してください。

一般的なセットアップエラーの修正

症状考えられる原因修正方法
すべての呼び出しで 401キーの不足、誤入力、または失効Authorization: Bearer <key>を、余分な引用符なしで送信してください
404 または HTML レスポンス間違ったパス、通常は /v1 の欠落/v1 で終わる完全なベース URL を使用
モデルが見つからない他のプロバイダからコピーしたモデル名uncensoredを使用
429とrate_limited1分あたりのリクエスト制限を超えた速度を落とすか、チャージしてトライアル制限からフル制限へ移行する
429とconcurrency一度にリクエストが多すぎる並列呼び出しを 8 に制限(トライアルキーでは 2)
429 と Retry-After: 5一時的な過負荷5秒待機して再試行
413 または本文の拒否8 MBを超えるリクエストプロンプトを削るか、ジョブを分割する

トライアル以上の準備ができたら、料金ページにチャージオプションが記載されています:$20〜$500の任意の整数額、暗号資産(TRC20上のUSDT、Base上のUSDC)で支払い、$50から5%ボーナス、$100から10%ボーナス、$200から15%ボーナスがあります。失敗または拒否されたリクエストは課金されず、プロンプトはトレーニングに使用されません。

質問と回答

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

いいえ。これは独立したホスト型でOpenAI互換のAPIであり、コンテンツ拒否なしで回答するようチューニングされた1つのオープンウェイトモデルを提供します。これは任意のモデルベンダーの公式APIではなく、ベンダー間のルーターでもありません。

試すためにクレジットカードは必要ですか?

いいえ。サインアップ後、APIキーページでワンクリックで$0.50の無料トライアルクレジットを取得できます。これは7日間有効で、1人あたり1回限りの制限があります。

リクエストで使用するモデル名は何ですか?

uncensoredを使用してください。このサービスはこの単一のモデルIDを公開しており、GET /v1/modelsで確認できます。

後からクレジットを追加するにはどうすればよいですか?

$20から$500までの任意の整数額をチャージしてください。ボーナスは$50(+5%)、$100(+10%)、$200(+15%)から適用され、クレジットは期限切れになりません。

OpenAI SDKを使用できますか?

はい。base_urlをhttps://api.minimaxapikey.com/v1 に設定し、キーを使用してモデルuncensoredに送信してください。コード内の他の変更は必要ありません。

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

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

API キーを取得