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

MiniMax-M3 - Anthropic 互換 API

  • Anthropic Messages プロトコルを使用して MiniMax-M3 モデルを呼び出します
  • リクエスト / レスポンス構造は Anthropic API と整合します
  • マルチモーダル対話:content はテキストと画像の content block に対応
  • システムプロンプト:トップレベルの system フィールドで渡します
  • 思考モード:thinking オブジェクトで制御。思考内容は content[type=thinking] block で返却
  • ストリーミング出力:SSE イベントストリーム
  • ツール呼び出し:Anthropic tool_use / tool_result フローに対応
<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 ``` **備考**:EvoLink は `/v1/messages` に対して一律で Bearer Token 認証を採用しています。

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json
modelenum<MiniMax-M3>必須

呼び出すモデル

"MiniMax-M3"
max_tokensinteger

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

1024
messagesobject[]必須

対話メッセージのリスト。user / assistant をターンごとに交互に並べます **説明**: - 少なくとも 1 件のメッセージを含む必要があります - 最後のメッセージは通常 `role=user` です

[
  {
    "role": "user",
    "content": null
  }
]
systemobject

システムプロンプト。AI の役割と振る舞いを設定するために使用します **説明**: - 文字列または文字列の配列に対応 - トップレベルの `system` フィールドで渡します

temperaturenumber

サンプリング温度 **説明**: - 範囲 `[0, 2]` - デフォルト 1;値が高いほど発散的に、低いほど確定的になります

1
top_pnumber

核サンプリングのしきい値 **説明**: - 範囲 `[0, 1]`、MiniMax-M3 のデフォルトは 0.95 - temperature と top_p を同時に調整しないことを推奨します

0.95
streamboolean

SSE ストリーミングで返すかどうか - `true`:Server-Sent Events のストリーミング返却 - `false`:完全なレスポンスを待ってから一括で返します(デフォルト)

false
thinkingobject

深い思考を制御します。thinking を有効にした場合、マルチターン対話では thinking ブロックを原文のまま返送する必要があります **説明**: - **デフォルトは `adaptive`**:モデルが問題の難易度に応じて深く思考するかを適応的に判断します - 有効時にはレスポンスの `content` 配列に `type="thinking"` の推論過程 block が含まれます(出力 token として課金されます)

{
  "type": "adaptive"
}
toolsobject[]

ツール定義リスト **説明**: - Anthropic の tool 定義仕様に従います - `input_schema` は JSON Schema オブジェクトを使用します

[
  {
    "name": "string",
    "description": "string",
    "input_schema": {},
    "cache_control": {
      "type": "ephemeral"
    }
  }
]
tool_choiceobject

ツール選択戦略。auto と none のみ対応します

{
  "type": "auto"
}
metadataobject

リクエストメタデータ

{
  "user_id": "string"
}

レスポンス

application/json
成功

レスポンスボディ

idstring

メッセージの一意の ID

"string"
typeenum<message>

レスポンスオブジェクトの種類

"message"
roleenum<assistant>
"assistant"
modelstring

実際に使用されたモデル

"MiniMax-M3"
contentobject[]

レスポンス content block リスト **含まれる可能性のある block type**: - `thinking`:推論過程(thinking が有効な場合のみ) - `text`:最終的な回答テキスト - `tool_use`:モデルが発起したツール呼び出し

[
  {
    "type": "text",
    "text": "string",
    "thinking": "string",
    "signature": "string",
    "id": "string",
    "name": "string",
    "input": {}
  }
]
stop_reasonenum<end_turn | max_tokens | tool_use>

停止理由 - `end_turn`:自然終了 - `max_tokens`:max_tokens の上限に到達 - `tool_use`:モデルがツール呼び出しをトリガー

"end_turn"
usageobject

Token 使用統計(Anthropic 規格)

{
  "input_tokens": 7,
  "output_tokens": 77,
  "cache_creation_input_tokens": 0,
  "cache_read_input_tokens": 0
}
POST/v1/messages
curl --request POST \
  --url https://api.starmagic.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "こんにちは、世界"
    }
  ]
}'
レスポンス: 成功
{
  "id": "066a381bdc3c0ded310e27c9a46d16e7",
  "type": "message",
  "role": "assistant",
  "model": "MiniMax-M3",
  "content": [
    {
      "type": "thinking",
      "thinking": "ユーザーが尋ねているのは日本の首都で、これは基礎的な地理の知識の質問です。答えは東京で、そのまま提示すればよいです。",
      "signature": "066a381bdc3c0ded310e27c9a46d16e7"
    },
    {
      "type": "text",
      "text": "日本の首都は**東京**です。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 7,
    "output_tokens": 77,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}