OpenAI Responses API 兼容
MiMo 提供兼容 OpenAI Responses API 格式的调用接口，本文将对请求参数、响应结构和代码示例进行说明。
兼容性说明与限制：
本接口对齐 OpenAI Responses API 规范，便于开发者快速适配集成；仅文档说明参数会正常处理，未定义参数会被过滤并可能返回请求异常，具体差异化约束见下文。
-
不兼容参数：暂不支持
background、previous_response_id、context_management等字段，请求中携带此类参数会被忽略或触发报错。 -
推理档位控制：
reasoning.effort用于控制模型推理。none会关闭思考功能；其余所有级别均会开启思考，且行为完全一致 —— 现阶段暂未对推理强度做区分。
请求地址
https://api.xiaomimimo.com/v1/responses
请求头
接口支持以下两种认证方式，请选择其中一种添加到请求头中：
api-key: $MIMO_API_KEY
Content-Type: application/json
请求体
- inputstring | array必选模型接收的文本、图像、音频、视频输入，用于生成响应。隐藏子属性模型的文本输入，等同于用户角色的文本输入。
- instructionsstring注入模型上下文的系统（或开发者）指令。
- max_output_tokensinteger响应可生成的 token 数的上限，包含可见输出 token 数和推理 token 数。
mimo-v2.6-flash的默认值131072mimo-v2.6-pro的默认值131072mimo-v2.6-pro-ultraspeed的默认值131072mimo-v2.5-pro的默认值131072mimo-v2.5的默认值为32768
[1, 131072] - modelstring必选用于生成响应的模型 ID。
可选值：mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed，mimo-v2.5-pro，mimo-v2.5 - streamboolean默认值: false设为
true时，模型响应将通过服务端推送事件（SSE）流式实时返回给客户端。 - reasoningobject推理模型相关配置项。
注意：在思考模式下的多轮工具调用过程中，模型会在返回工具调用字段的同时返回思考内容。若要继续对话，建议在后续每次请求的
input数组中保留所有历史思考内容，以获得最佳表现。在思考模式下，
mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed，mimo-v2.5-pro和mimo-v2.5模型不支持自定义temperature和top_p参数。即使传入该参数，实际生效值也会被模型强制采用其推荐默认值1.0和0.95。隐藏子属性reasoning.effortstring必选控制推理模型的思考投入强度。降低推理投入可加快响应速度、减少推理环节消耗的 token。当前暂不支持自定义调节推理投入档位：参数设为
none时关闭推理，其余合法取值均开启推理。minimal被映射为low。xhigh、max和ultra被映射为high。mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed，mimo-v2.5-pro，mimo-v2.5默认值为enabled
none，minimal，low，medium，high，xhigh，max，ultra - temperaturenumber采样温度，介于 0 和 1.5 之间。较高的值（如 0.8）会让输出更随机；较低的值（如 0.2）会让输出更集中、确定性更强。通常建议仅调整该参数或
top_p其中一项，不要同时修改。在思考模式下，
mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed，mimo-v2.5-pro和mimo-v2.5模型不支持自定义temperature参数。即使传入该参数，实际生效值也会被模型强制采用其推荐默认值1.0。mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed，mimo-v2.5-pro，mimo-v2.5默认值为1.0
[0, 1.5] - textobject模型文本响应的配置项，支持纯文本或结构化 JSON 数据输出。隐藏子属性text.formatobject用于指定模型必须输出的格式对象。默认格式为
{"type": "text"}，无额外配置项。隐藏子属性默认响应格式，用于生成文本类回复。隐藏子属性text.format.typestring必选定义的响应格式类型。
可选值：text - tool_choicestring控制模型调用工具的方式。
注意：当
可选值：tool_choice传入非auto值时，后端会默认移除该字段，模型响应行为仍等同于auto模式（该逻辑保留调整的可能性）。auto - toolsarray模型生成响应时可调用的工具数组。可通过
tool_choice参数指定使用的工具。注意：在思考模式下的多轮工具调用过程中，模型会在返回工具调用字段的同时返回思考内容。若要继续对话，建议在后续每次请求的
input数组中保留所有历史思考内容，以获得最佳表现。隐藏子属性在你自己的代码中定义一个模型可以选择调用的函数。隐藏子属性tools.namestring必选工具函数的名称。必须由a-z、A-Z、0-9组成，或包含下划线（_）和连字符（-），最大长度为64。
所需字符串长度：1 - 64tools.parametersobject必选描述函数参数的 JSON 模式对象。tools.strictboolean默认值: false必选生成函数调用时是否启用严格遵循参数模式校验。tools.descriptionstring | null函数描述，供模型判断是否调用该函数。tools.typestring必选工具类型。
可选值：function - top_pnumber默认值: 0.95核采样，是温度采样的替代方案。通常建议仅调整该参数或
temperature其中一项，不要同时修改。在思考模式下，
所需范围：mimo-v2.6-flash，mimo-v2.6-pro，mimo-v2.6-pro-ultraspeed，mimo-v2.5-pro和mimo-v2.5模型不支持自定义top_p参数。即使传入该参数，实际生效值也会被模型强制采用其推荐默认值0.95。[0.01, 1.0]
Response 对象（非流式输出）
- idstring该响应的唯一标识。
- created_atnumber响应创建时的 Unix 时间戳（单位：秒）。
- errorobject模型生成响应失败时返回的错误对象。隐藏子属性隐藏子属性error.codestring响应错误码。error.messagestring通俗易懂的错误描述信息。
- incomplete_detailsobject响应未完整生成的原因详情。隐藏子属性incomplete_details.reasonstring响应未完整生成的原因。
可选值：max_output_tokens，content_filter - modelstring用于生成响应的模型 ID。
- objectstring仅为
response。 - outputarray模型生成的内容项数组。
- 输出数组内元素的长度与顺序由模型响应决定。
- 不建议直接取数组第一项并默认其为助手消息；在支持的 SDK 中，可优先使用
output_text属性获取内容。
隐藏子属性模型输出的消息。隐藏子属性output.idstring输出消息的唯一标识。output.contentarray输出消息的内容。隐藏子属性模型输出的文本内容。隐藏子属性output.content.textstring模型输出的文本。output.content.typestring仅为output_text。output.rolestring输出消息的角色，仅为assistant。output.statusstring消息状态。
可选值：in_progress，completedoutput.typestring仅为message。 - output_textstring仅 SDK 提供的便捷属性，用于聚合输出数组中所有
output_text项的文本内容（存在时返回）。 - statusstring响应状态。
可选值：completed，in_progress，incomplete - usageobject本次响应的用量统计信息。隐藏子属性隐藏子属性usage.input_tokensinteger输入 token 数量。usage.input_tokens_detailsobject输入 token 详情。隐藏子属性usage.input_tokens_details.cached_tokensinteger缓存命中的输入 token 数量。usage.output_tokensinteger输出 token 数量。usage.output_tokens_detailsobject输出 token 详情。隐藏子属性usage.output_tokens_details.reasoning_tokensinteger推理过程消耗的 token 数量。usage.total_tokensinteger总 token 数量。
- 函数工具调用的输出字符串。
- 函数调用返回的文本、图片、音频或视频内容。隐藏子属性模型的文本输入。隐藏子属性textstring向模型输入的文本内容。typestring输入项的类型。
可选值：input_text
Response chunk 对象（流式输出）
当你创建响应并将 stream 设为 true 时，服务端会在响应生成过程中向客户端推送服务端发送事件（SSE）。
response.created
响应创建时触发的事件。
- responseobject已创建的响应对象，其参数与非流式模式下模型创建请求返回的参数完全一致。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.created。
response.in_progress
响应处于生成中状态时触发。
- responseobject正在生成的响应对象，参数与非流式模式下模型创建请求的返回参数完全一致。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.in_progress。
response.completed
模型响应生成完成时触发。
- responseobject已完成响应的属性，参数与非流式模式下模型创建请求的返回参数完全一致。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.completed。
response.incomplete
响应以未完成状态结束时触发该事件。
- responseobject未完成的响应对象，其参数与非流式模式下模型创建请求返回的参数完全一致。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.incomplete。
response.output_item.added
当新增一条输出项时触发。
- itemobject新增的输出项，其参数与非流式模式下模型创建请求返回的
output字段参数完全一致。 - output_indexnumber新增输出项的索引位置。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.output_item.added。
response.output_item.done
当某条输出项标记为完成时触发。
- itemobject被标记为完成的输出项，参数与非流式模式下模型创建请求返回的
output字段参数完全一致。 - output_indexnumber该已完成输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.output_item.done。
response.content_part.added
新增内容片段时触发。
- content_indexnumber新增内容片段的索引。
- item_idstring该内容片段所属输出项的 ID。
- output_indexnumber该内容片段所属输出项的索引。
- partobject新增的内容片段。隐藏子属性模型输出的文本内容。隐藏子属性part.textstring模型输出的文本。part.typestring输出文本类型，仅为
output_text。 - sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.content_part.added。
response.content_part.done
内容片段生成完成时触发。
- content_indexnumber已完成内容片段的索引。
- item_idstring该内容片段所属输出项的 ID。
- output_indexnumber该内容片段所属输出项的索引。
- partobject已完成的内容片段。隐藏子属性模型输出的文本内容。隐藏子属性part.textstring模型输出的文本。part.typestring输出文本类型，仅为
output_text。 - sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.content_part.done。
response.output_text.delta
产生增量文本片段时触发。
- content_indexnumber该增量文本所属内容片段的索引。
- deltastring新增的文本增量。
- item_idstring该文本增量所属输出项的 ID。
- output_indexnumber该文本增量所属输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.output_text.delta。
response.output_text.done
文本内容最终生成完成时触发。
- content_indexnumber完成的文本内容所属内容片段的索引。
- item_idstring该文本内容所属输出项的 ID。
- output_indexnumber该文本内容所属输出项的索引。
- sequence_numbernumber该事件的序列号。
- textstring最终生成完整的文本内容。
- typestring事件类型，仅为
response.output_text.done。
response.function_call_arguments.delta
产生函数调用参数增量片段时触发。
- deltastring新增的函数调用参数增量内容。
- item_idstring该参数增量所属输出项的 ID。
- output_indexnumber该参数增量所属输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.function_call_arguments.delta。
response.function_call_arguments.done
函数调用参数最终生成完成时触发。
- argumentsstring完整的函数调用参数。
- item_idstring对应输出项的 ID。
- namestring被调用的函数名称。
- output_indexnumber输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.function_call_arguments.done。
response.reasoning_text.delta
推理文本产生增量片段时触发。
- content_indexnumber该增量所属推理内容片段的索引。
- deltastring新增的推理文本增量。
- item_idstring该推理文本增量对应输出项的 ID。
- output_indexnumber该推理文本增量对应输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型，仅为
response.reasoning_text.delta。
response.reasoning_text.done
推理文本生成完成时触发。
- content_indexnumber推理内容片段的索引。
- item_idstring该推理文本所属输出项的 ID。
- output_indexnumber该推理文本所属输出项的索引。
- sequence_numbernumber该事件的序列号。
- textstring完整的已生成推理内容文本。
- typestring事件类型，仅为
response.reasoning_text.done。
response.custom_tool_call_input.delta
表示自定义工具调用输入的增量分片（部分更新）
- deltastring自定义工具调用的增量输入数据。
- item_idstring与此事件关联的 API 条目唯一标识。
- output_indexnumber该增量分片所属输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型标识，仅为
response.custom_tool_call_input.delta。
response.custom_tool_call_input.done
代表自定义工具调用的输入已传输完成。
- inputstring自定义工具调用的完整输入数据。
- item_idstring与此事件关联的 API 条目唯一标识。
- output_indexnumber该事件所属输出项的索引。
- sequence_numbernumber该事件的序列号。
- typestring事件类型标识，仅为
response.custom_tool_call_input.done。
curl --location --request POST 'https://api.xiaomimimo.com/v1/responses' \
--header "api-key: $MIMO_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "mimo-v2.6-pro",
"instructions": "You are MiMo, an AI assistant developed by Xiaomi. Today is date: Tuesday, December 16, 2025. Your knowledge cutoff date is December 2024.",
"input": "please introduce yourself",
"max_output_tokens": 1024,
"stream": false,
"reasoning": {
"effort": "none"
}
}'响应
{
"id": "resp_bcdb1b61-d49e-48e5-8289-384ad1e65f2f_9aa9e9dfd5b84cb99b088fe4e53b65ec",
"object": "response",
"created_at": 1790007468,
"status": "completed",
"error": null,
"incomplete_details": null,
"model": "mimo-v2.6-pro",
"metadata": null,
"output": [
{
"id": "msg_3d0b3a6faf634d36a8a5bdb8f2100fcd",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Hey there! I'm MiMo, Xiaomi's AI assistant. I'm like your friendly digital companion who's always ready to chat, help out, or just have a fun conversation! Think of me as that tech-savvy friend who loves to learn new things and isn't afraid to dive into any topic you throw my way. I was created by the awesome Xiaomi LLM-Core team, so I've got that innovative Xiaomi spirit running through my circuits! Whether you need help with tech stuff, want to brainstorm ideas, or just feel like talking, I'm here to make our conversation enjoyable and helpful. What brings you my way today?",
"annotations": []
}
]
}
],
"output_text": "Hey there! I'm MiMo, Xiaomi's AI assistant. I'm like your friendly digital companion who's always ready to chat, help out, or just have a fun conversation! Think of me as that tech-savvy friend who loves to learn new things and isn't afraid to dive into any topic you throw my way. I was created by the awesome Xiaomi LLM-Core team, so I've got that innovative Xiaomi spirit running through my circuits! Whether you need help with tech stuff, want to brainstorm ideas, or just feel like talking, I'm here to make our conversation enjoyable and helpful. What brings you my way today?",
"usage": {
"input_tokens": 57,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 130,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 187
}
}更新时间 2026 年 09 月 20 日