テキストモデル上級者向け更新日
POST/v1/chat/completions
MiniMax M3
リクエスト ID MiniMax-M3
プロトコル
POST /v1/chat/completions· Chat Completionsの例POST /v1/messages· Anthropic Messagesの例POST /v1/messages/count_tokens· Count Tokensの例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
Authorization: Bearer YOUR_API_KEY- Anthropic Messages ·
x-api-key: YOUR_API_KEY
リクエストパラメータ
POST /v1/chat/completions
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に MiniMax-M3 を指定します。 |
messages | object[] | 必須 | 会話順に送信します。各メッセージに role と content を指定します。 |
messages[].content | string / object[] | 条件付き | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
max_completion_tokens | integer | 条件付き | 推論トークンを含む生成トークン数を制限します。この項目に対応する接続先で使います。 |
max_tokens | integer | 条件付き | 出力トークン上限の互換項目です。接続先の要件に応じて、この項目か max_completion_tokens の一方を指定します。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
response_format | object | 条件付き | 構造化出力には type: json_object を使います。JSON Schema に対応する接続先では type: json_schema と json_schema を指定できます。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | string / object | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
POST /v1/messages
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に MiniMax-M3 を指定します。 |
messages | object[] | 必須 | user と assistant のメッセージを順に送信します。システム指示は最上位の system に入れます。 |
messages[].content | string / object[] | 必須 | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
system | string / object[] | 任意 | システム指示。テキストまたはテキストブロックの配列を指定します。 |
max_tokens | integer | 必須 | 出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | object | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
POST /v1/messages/count_tokens
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に MiniMax-M3 を指定します。 |
messages | object[] | 必須 | user と assistant のメッセージを順に送信します。システム指示は最上位の system に入れます。 |
messages[].content | string / object[] | 必須 | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
system | string / object[] | 任意 | システム指示。テキストまたはテキストブロックの配列を指定します。 |
tools | object[] | 条件付き | 入力トークンの計算に含めるツール定義。Messages リクエストと同じツールを送信します。 |
リクエスト例
API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。
Chat Completions
bash
curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "MiniMax-M3",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
],
"stream": false
}'
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "MiniMax-M3",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
Count Tokens
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "MiniMax-M3",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
レスポンスの読み取り
- Chat Completions ·
choices[].message.contentからテキストを取得します。SSE ではchoices[].deltaから差分を読み取ります。 JSON · SSE - Anthropic Messages ·
content[]からタイプがtextのブロックを取得します。ストリーミングでは SSE のコンテンツブロックイベントを順に処理します。 JSON · SSE - Count Tokens ·
input_tokensから入力トークン数を取得します。
機能と制限
streaming· 対応tool_calling· 条件付き対応 — 互換プロトコルとリクエスト形式によって異なりますimage_input· 未公開video_input· 非対応