StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
統合ガイド
MiniMax-M3 - OpenAI-Compatible APIMiniMax-M3 - Anthropic-Compatible API
StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
テキストMiniMaxMinimax.M3

MiniMax-M3 - OpenAI 互換 API

  • OpenAI Chat Completions プロトコルを使用して MiniMax-M3 モデルを呼び出します
  • マルチターン対話:シングルターンまたはマルチターンの文脈対話に対応
  • システムプロンプト:role=system メッセージで AI の役割と振る舞いをカスタマイズ
  • マルチモーダル入力:content はテキスト + 画像 / 動画の混在に対応
  • 思考モード:thinking.type で制御し、思考内容は reasoning_content で返却
  • ストリーミング出力:SSE ストリーミングレスポンスに対応
  • ツール呼び出し:Function Calling に対応
<Note> **BaseURL**:デフォルトの BaseURL は `https://api.starmagic.ai` で、テキストモデルへの対応が優れており、長時間接続をサポートします。`https://api.starmagic.ai` はマルチモーダルサービスの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。 </Note>

認証

Authorizationstringheader必須

##すべての API は Bearer Token 認証が必要です## **API キーの取得:** [API キー管理ページ](https://starmagic.ai/app/api-keys)にアクセスして API キーを取得してください **リクエストヘッダーに追加:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json
modelenum<MiniMax-M3>必須

対話モデル名

"MiniMax-M3"
messagesobject[]必須

対話メッセージのリスト。マルチターン対話に対応 役割が異なるメッセージは異なるフィールド構造を持つため、対応する役割を選択して確認してください

[
  null
]
thinkingobject

深い思考を制御します **説明**: - **デフォルトは `adaptive`**:モデルが問題の難易度に応じて深く思考するかを適応的に判断します - デフォルトでは思考内容はレスポンスの `content` 内にインラインされます(`<think>...</think>` で囲まれます)。独立したフィールドに分離したい場合は `reasoning_split` を併用してください

{
  "type": "adaptive"
}
reasoning_splitboolean

思考内容を独立したフィールドに分離するかどうか - `false`(デフォルト):思考内容は `content` 内にインラインされ、`<think>...</think>` で囲まれます - `true`:思考内容は `choices[].message.reasoning_content` と `reasoning_details` に分離されます

true
temperaturenumber

サンプリング温度。出力のランダム性を制御します **説明**: - 低い値(例:0.2):より確定的で焦点の絞られた出力 - 高い値(例:1.5):よりランダムで創造的な出力 - 範囲 `[0, 2]`、デフォルト 1

1
top_pnumber

核サンプリング(Nucleus Sampling)パラメータ **説明**: - 累積確率が上位のトークンからのサンプリングを制御します - 例えば 0.95 は累積確率が 95% に達するトークンから選択することを意味します - 範囲 `[0, 1]`、MiniMax-M3 のデフォルトは 0.95 **推奨**:temperature と top_p を同時に調整しないでください

0.95
max_completion_tokensinteger

生成内容の長さの上限(Token 数) **説明**: - MiniMax-M3 は **131,072**(128K)を推奨、上限は **524,288**(512K) - 思考によって生成されるトークンもこの上限に含まれます - 生成が `length` の理由で中断された場合は、この値を引き上げてみてください

131072
streamboolean

レスポンスをストリーミング方式で返すかどうか - `true`:ストリーミング返却。SSE(Server-Sent Events)でチャンクごとにリアルタイムで内容を返します - `false`:完全なレスポンスを待ってから一括で返します(デフォルト)

false
stream_optionsobject

ストリーミングレスポンスのオプション `stream=true` の場合のみ有効です

{
  "include_usage": true
}
toolsobject[]

Function Calling 用のツール定義リスト 各ツールには名前、説明、パラメータ schema が必要です

[
  {
    "type": "function",
    "function": {
      "name": "string",
      "description": "string",
      "parameters": {}
    }
  }
]
max_tokensinteger

旧版の生成長さ制限パラメータ **説明**:非推奨です。代わりに `max_completion_tokens` を使用してください

0

レスポンス

application/json
成功

レスポンスボディ

idstring

対話完了の一意の識別子

"0668a381bdc3c0ded310e27c9a46d16e7"
modelstring

実際に使用されたモデル名

"MiniMax-M3"
objectenum<chat.completion>

レスポンスの種類

"chat.completion"
createdinteger

作成タイムスタンプ(Unix 秒)

1777026807
choicesobject[]

対話生成の選択肢リスト

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "こんにちは!私は MiniMax-M3 です。対話、執筆、推論、コーディングなど、さまざまなタスクをお手伝いできます。",
      "reasoning_content": "この問題を分析してみましょう...",
      "reasoning_details": [
        {
          "type": null,
          "id": null,
          "format": null,
          "index": null,
          "text": null
        }
      ],
      "name": "string",
      "audio_content": "string",
      "tool_calls": [
        {
          "id": null,
          "type": null,
          "function": null,
          "index": null
        }
      ]
    },
    "finish_reason": "stop"
  }
]
usageobject

Token 使用統計情報

{
  "total_tokens": 1604,
  "total_characters": 0,
  "prompt_tokens": 1365,
  "completion_tokens": 239,
  "prompt_tokens_details": {
    "cached_tokens": 114
  }
}
input_sensitiveboolean

入力内容がセンシティブワードフィルターに該当したかどうか。入力が重大な違反の場合、API はコンテンツ違反エラーを返し、レスポンス内容は空になります

true
input_sensitive_typeinteger

入力が該当したセンシティブワードの種類(`input_sensitive` が true の場合に返却):1 重大な違反;2 ポルノ;3 広告;4 禁止コンテンツ;5 暴言;6 暴力 / テロ;7 その他

0
output_sensitiveboolean

出力内容がセンシティブワードフィルターに該当したかどうか

true
output_sensitive_typeinteger

出力が該当したセンシティブワードの種類

0
base_respobject

ステータスコードとエラー詳細

{
  "status_code": 0,
  "status_msg": "string"
}
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "messages": [
    {
      "role": "user",
      "content": "自己紹介してください"
    }
  ]
}'
レスポンス: 成功
{
  "id": "066b36619b147e326d17053cccdef70f",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "<think>\nユーザーが尋ねているのはフランスの首都で、これは一般常識の質問です。答えはパリで、そのまま提示すればよいです。\n</think>\nフランスの首都は**パリ**です。",
        "role": "assistant",
        "name": "MiniMax AI",
        "audio_content": ""
      }
    }
  ],
  "created": 1777026807,
  "model": "MiniMax-M3",
  "object": "chat.completion",
  "usage": {
    "total_tokens": 60,
    "total_characters": 0,
    "prompt_tokens": 7,
    "completion_tokens": 53,
    "prompt_tokens_details": {
      "cached_tokens": 0
    }
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "input_sensitive_type": 0,
  "output_sensitive_type": 0,
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}