API 參考聊天
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 文件