MiniMax API：クイックスタートとSDKガイド

認証とベースURL

提供されたAPIキーを使用し、クライアントを専用ベースURLにポイントします。レスポンス生成のエンドポイントは https://api.minimaxaiapi.com/v1/chat/completionsキーを Authorization ヘッダーを Bearer トークンとして使用します。これは、同じプロトコルに従っているため、標準的な OpenAI SDK のいずれかでも動作します。

• ヘッダー名： Authorization
• ヘッダー値： Bearer YOUR_API_KEY
• ベースURL： https://api.minimaxaiapi.com/v1

複雑なセットアップは不要です。既存プロジェクトの設定を更新するだけです。

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

チャット完了エンドポイント

チャット完了エンドポイントにPOSTリクエストを送信して、テキスト応答を取得します。モデル識別子は uncensored. 会話履歴を含むmessages配列を含める必要があります。システムは入力を処理し、プロンプトに基づいて生成されたテキストを返します。

このエンドポイントはすべてのテキスト生成を処理します。埋め込み、音声、ビデオはサポートしていません。応答をストリーミングするか、完全なブロックを待機することができます。モデルは合計100,000トークンのコンテキストを処理します。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.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)

ストリーミングとトークン使用量

streamをtrueに設定してストリーミングを有効にする stream: true リクエストに含まれます。APIは生成されたトークンごとにサーバー送信イベント（SSE）を返します。これにより、出力のリアルタイム表示が可能です。トークン使用統計はストリームの最後のチャンクに含まれます。これにより、個々のトークンをすべて解析することなく、コストを正確に追跡できます。

ストリーミングにより長文のレスポンスの体感レイテンシーを低減できます。チャットインターフェースや動的なコンテンツ生成に最適です。ユーザーが生成を中断した場合、ストリームを早期に停止できます。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxaiapi.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);

関数呼び出しとJSONモード

を使用 tools 関数呼び出しを有効にするパラメータ。リクエストボディに関数を定義し、モデルにどの関数を呼び出すか選ばせます。 tool_choice パラメータは特定の関数を強制または自動選択させます。厳格なJSON出力の場合、 response_format に {"type": "json_object"}. これにより、レスポンスが有効な JSON になります。

関数呼び出しは構造化データの抽出やアクションのトリガーに有用です。JSONモードは予測可能なフォーマットを必要とするAPI統合に最適です。堅牢なアプリケーションロジックのために両方を組み合わせます。

Copystream = 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)

モデルパラメータと制約

などの標準的なパラメータを使用して生成動作を調整する temperature, top_p、および stop. 最大コンテキストウィンドウは、プロンプトとコンプリーションを含めて100,000トークンです。1リクエストあたりの最大出力は16,000トークンです。設定しない場合、 max_tokens, 制限値はデフォルトで2,048トークンです。

使用 seed 再現性のために。 presence_penalty および frequency_penalty 反復を制御します。これらのパラメータにより、モデルの創造性と一貫性を細かく制御できます。特定のユースケースでテストして、適切なバランスを見つけてください。

レート制限とエラー

APIはキーあたり1分あたり300リクエストと8つの同時リクエストの制限を適用します。これらの制限を超えると、429エラーが発生します。401エラーは無効または欠落したAPIキーを示し、402エラーは前払いクレジットが枯渇したことを意味します。

エラーはクレジットを消費しません。失敗したリクエストをペナルティなしで再試行できます。リクエストボディのサイズは8 MBに制限されています。スロットリングを避けるために並列処理を慎重に管理してください。ストリーミングレスポンスの最終チャンクを通じて使用状況を監視してください。