API ReferenceChat
Anthropic 兼容 API
使用 Anthropic 兼容端点,通过 Messages API 格式与 MiMo 模型交互。
端点
POST https://api.mimo-v2.com/anthropic/v1/messages认证
使用以下请求头进行身份验证:
| 请求头 | 格式 |
|---|---|
api-key | <your-api-key> |
您可以在 Mimo 控制台的 设置 → API 密钥 中生成 API 密钥。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID。可选值:mimo-v2-pro、mimo-v2-omni、mimo-v2-flash |
messages | array | 是 | 消息对象数组 |
max_tokens | integer | 是 | 最大生成 token 数 |
system | string | 否 | 系统提示词 |
temperature | number | 否 | 采样温度(默认:1.0) |
top_p | number | 否 | 核采样(默认:0.95) |
stream | boolean | 否 | 启用流式输出(默认:false) |
stop_sequences | array | 否 | 停止序列 |
消息对象
| 字段 | 类型 | 说明 |
|---|---|---|
role | string | 可选值:user、assistant |
content | string/array | 消息内容(文本或内容块数组) |
请求示例
curl https://api.mimo-v2.com/anthropic/v1/messages \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"model": "mimo-v2-pro",
"max_tokens": 1024,
"system": "You are a helpful assistant.",
"messages": [
{"role": "user", "content": "你好,你是谁?"}
]
}'响应格式
{
"id": "msg_xxx",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello! I am MiMo..."
}
],
"model": "mimo-v2-pro",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 50,
"output_tokens": 100
}
}响应字段
| 字段 | 说明 |
|---|---|
id | 消息的唯一标识符 |
type | 固定为 message |
role | 固定为 assistant |
content | 内容块数组 |
content[].type | 内容块类型(如 text) |
content[].text | 生成的文本 |
model | 使用的模型 |
stop_reason | 模型停止原因:end_turn、max_tokens 或 stop_sequence |
usage | Token 使用统计 |
流式响应
当 stream 设为 true 时,API 返回 Server-Sent Events(SSE)。流由一系列类型化事件组成。
流式请求示例
curl https://api.mimo-v2.com/anthropic/v1/messages \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"model": "mimo-v2-pro",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "你好!"}
],
"stream": true
}'流式事件格式
流会发出一系列不同类型的 SSE 事件:
event: message_start
data: {"type":"message_start","message":{"id":"msg_xxx","type":"message","role":"assistant","content":[],"model":"mimo-v2-pro","stop_reason":null,"usage":{"input_tokens":50,"output_tokens":0}}}
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":"你好"}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"!"}}
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":15}}
event: message_stop
data: {"type":"message_stop"}流事件类型
| 事件 | 说明 |
|---|---|
message_start | 表示消息开始,包含元数据 |
content_block_start | 标记新内容块的开始 |
content_block_delta | 包含增量文本内容 |
content_block_stop | 标记内容块的结束 |
message_delta | 包含消息级别的更新(如停止原因) |
message_stop | 表示流的结束 |
与 OpenAI 流式格式不同,Anthropic 兼容的流式输出使用类型化事件,每个 SSE 事件包含 event: 字段和 data: 字段。
MiMo API 文件