MiniMax Messages

用一个 BeatAPI 密钥，以 Anthropic Messages 格式调用 MiniMax M3。

• 一个端点 POST /v1/messages 即可调用 MiniMax M3。
• 支持流式输出和工具调用，上下文窗口为 100 万 token。提示词超过 512,000 token 后费率翻倍。
• 兼容 Anthropic SDK：改 base URL，换成 BeatAPI 密钥即可。每个请求都要带 anthropic-version 请求头。
• tool_choice 会传给模型，但不是每个模型都执行；thinking 不生效。详见下面的请求参数。

在调试窗口里打开本接口，填入你的 BeatAPI API 密钥即可发送。调用是真实的，费用从你自己的余额中扣除。

模型

把下面的 ID 作为 model 发送。

• 价格为基础档，已计入折扣。长上下文档、缓存命中输入价和缓存写入价不在本表内，见价格表。
• — 表示目录未公布该数字。

快速开始

在服务端安装 @anthropic-ai/sdk 或 anthropic 包，把密钥放在 BEATAPI_API_KEY，不要把它写进浏览器代码。SDK 会自动带上 anthropic-version 请求头。以下是请求示例，不是真实的模型输出记录。

从 content 里的 text 块读取答案，再检查 stop_reason 和 usage。HTTP 200 不能证明答案满足你的任务，请在应用里校验内容。文本请求直接返回，不要为它们轮询 /v1/tasks。

curl --request POST \
  --url https://direct.beatapi.io/v1/messages \
  --header "x-api-key: $BEATAPI_API_KEY" \
  --header 'anthropic-version: 2023-06-01' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'

端点与鉴权

POST https://direct.beatapi.io/v1/messages

每个请求都要带 anthropic-version 请求头（例如 2023-06-01），Anthropic SDK 会自动添加。鉴权可以用 x-api-key，也可以用 Authorization: Bearer <BEATAPI_API_KEY>。

请求参数

请求使用 Anthropic Messages 的格式。下列字段会生效；最后两个字段 SDK 可以发送，但不会改变结果。本页没有列出的字段，不保证有任何效果。

长上下文计费

MiniMax-M3 在提示词超过 512,000 token 后进入更高的费率档，更高的费率对整次请求生效：输入、缓存输入和输出的费率都翻倍。这是阶梯，不是逐步上涨：只超过一个 token 的请求，也整单按更高费率计费。

上面模型表和价格表里的价格是基础费率，适用于未超过阈值的提示词。发送很长的历史之前，先估算完整提示词的长度。

响应

非流式调用返回一个 JSON 对象。以下是精简后的示例。

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "MiniMax-M3",
  "content": [
    {
      "type": "text",
      "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16
  }
}

响应字段

流式输出

设置 "stream": true。流以 message_start 开始，以 message_stop 结束；中间的内容块通过 content_block_start、content_block_delta 和 content_block_stop 事件到达，message_delta 携带 stop_reason。

• 响应类型是 text/event-stream；不流式时是 application/json。
• 文本通过 text_delta 事件到达。推理型号会在文本块之前，先用 thinking_delta 事件发送一个 thinking 块。工具参数通过 input_json_delta 事件到达。
• 调用模型之前就失败的请求，返回的是带 HTTP 状态码的普通 JSON 错误，而不是流事件。
• 请设置明确的超时，并安全地重连流式响应。

event: message_start
data: {"type":"message_start","message":{"id":"msg_example","type":"message","role":"assistant","content":[],"usage":{"input_tokens":19,"output_tokens":1}}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Retry"}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":" with backoff"}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":16}}
event: message_stop
data: {"type":"message_stop"}

错误

HTTP 错误速查

认证、路由、限速和未知模型这几类失败发生在调用模型之前，返回 BeatAPI 信封：error.code、error.message、retryable、request_id。其余失败保持 Anthropic 格式 {"type": "error", "error": {"type", "message"}}：错误码在 error.type，request id 附在 message 末尾。详见错误码。

完整的错误码表和重试策略见错误码。

注意事项

• MiniMax 也可以用 Chat Completions 和 OpenAI Responses 调用。
• 本页介绍 MiniMax 文本模型。MiniMax H3 视频模型使用 Video API。
• 每个请求都要带 anthropic-version。不要依赖 thinking：它不生效。
• 密钥只放在可信的服务端，记录响应里的请求 ID，只对 429、500 和 503 重试。