OpenAI API 兼容

请求地址

https://api.xiaomimimo.com/v1/chat/completions

请求头

接口支持以下两种认证方式，请选择其中一种添加到请求头中：

方式一：api-key 字段认证，格式：

api-key: $MIMO_API_KEY
Content-Type: application/json

方式二：Authorization: Bearer 认证，格式：

Authorization: Bearer $MIMO_API_KEY
Content-Type: application/json

请求体

messagesarray必选
对话的消息列表。
隐藏子属性
开发者提供的指令，模型应遵循这些指令，而不受用户发送的消息影响。
隐藏子属性
messages.contentstring | array必选
开发者消息的内容。
隐藏子属性
开发者消息的内容。

messages.rolestring必选

开发者消息的角色。
可选值：developer

messages.namestring

参与者的可选名称。为模型提供信息以区分相同角色的参与者。

Chat 响应对象（非流式输出）

choicesarray
包含生成的回复选项列表。
隐藏子属性
choices.finish_reasonstring
模型停止生成 token 的原因。如果模型到达自然停止点或提供的停止序列，则为 stop；如果达到请求中指定的最大 token 数，则为 length；如果模型调用了工具，则为 tool_calls。如果内容因触发过滤策略而被拦截，则为 content_filter；如果模型检测到了复读，则为 repetition_truncation。

choices.indexinteger

选项列表中对应选项的索引。

choices.messageobject

模型生成的对话补全消息。

隐藏子属性

choices.message.contentstring

消息的内容。

choices.message.reasoning_contentstring

助手消息中最终答案之前的推理内容。

choices.message.rolestring

消息作者的角色。

choices.message.tool_callsarray

函数调用启动后，模型会返回待调用的工具以及该调用所需的参数。此参数可包含一个或多个工具响应对象。

隐藏子属性

模型创建的对函数工具的调用。

隐藏子属性

choices.message.tool_calls.functionobject

模型所调用的函数。

隐藏子属性

choices.message.tool_calls.function.argumentsstring

模型生成的用于调用函数的参数，格式为 JSON。请注意，模型生成的内容并非并非总能保证是有效的 JSON，且可能会虚构出函数模式中未定义的参数。在调用函数之前，请在代码中对这些参数进行验证。

choices.message.tool_calls.function.namestring

要调用的函数的名称。

choices.message.tool_calls.idstring

工具调用的 ID。

choices.message.tool_calls.typestring

工具的类型。目前仅支持 function。

choices.message.annotationsarray

联网搜索后，模型会返回全部引用网址的注释。

隐藏子属性

模型创建的对联网搜索的调用。

隐藏子属性

choices.message.annotations.logo_urlstring

logo网址。

choices.message.annotations.publish_timestring

发布时间。

choices.message.annotations.site_namestring

网站名称。

choices.message.annotations.summarystring

总结。

choices.message.annotations.titlestring

标题。

choices.message.annotations.typestring

类型。

choices.message.annotations.urlstring

网址。

choices.message.error_messagestring

联网搜索的错误信息。

choices.message.audioobject

如果请求输出音频，该对象将包含有关模型音频响应的数据。

隐藏子属性

choices.message.audio.idstring

此音频响应的唯一标识符。

choices.message.audio.datastring

模型生成的 Base64 编码音频，格式为请求中指定的格式。

choices.message.audio.expires_atnumber | null

此音频响应过期的 Unix 时间戳（以秒为单位）。当前仅为 null。

choices.message.audio.transcriptstring | null

模型生成的音频的文字记录。当前仅为 null。

createdinteger

对话补全对象创建时的 Unix 时间戳（以秒为单位）。

idstring

响应的唯一标识符。

modelstring

用于生成结果的模型。

objectstring

对象类型，仅为 chat.completion。

usageobject | null

该对话补全请求的用量信息。

隐藏子属性

usage.completion_tokensinteger

模型输出内容花费的 token。

usage.prompt_tokensinteger

提示词使用的 token 数量。

usage.total_tokensinteger

请求中使用的 token 总数（提示词 + 补全结果）。

usage.completion_tokens_detailsobject

补全中使用的 token 数量明细。

隐藏子属性

usage.completion_tokens_details.reasoning_tokensinteger

模型为推理生成的 token 数量。

usage.prompt_tokens_detailsobject

提示中使用的 token 数量明细。

隐藏子属性

usage.prompt_tokens_details.cached_tokensinteger

缓存中提供的 token 数量。

usage.prompt_tokens_details.audio_tokensinteger

提示中存在的音频输入 token 数量。

usage.prompt_tokens_details.image_tokensinteger

提示中存在的图像输入 token 数量。

usage.prompt_tokens_details.video_tokensinteger

提示中存在的视频输入 token 数量。

usage.web_search_usageobject

联网搜索 api 的调用量明细。

隐藏子属性

usage.web_search_usage.tool_usageinteger

联网搜索 api 的调用次数。

usage.web_search_usage.page_usageinteger

联网搜索 api 返回的网页数。

Chat 响应chunk对象（流式输出）

choicesarray
包含生成的回复选项列表。
隐藏子属性
choices.deltaobject
流式模型响应生成的对话补全增量。
隐藏子属性
choices.delta.contentstring
数据块消息的内容。

choices.delta.reasoning_contentstring

助手消息中最终答案之前的推理内容。

choices.delta.rolestring

消息作者的角色。

choices.delta.tool_callsarray

函数调用启动后，模型会返回待调用的工具以及该调用所需的参数。此参数可包含一个或多个工具响应对象。

隐藏子属性

choices.delta.tool_calls.indexinteger

在 tool_calls 列表中被调用工具的索引，从 0 开始。

choices.delta.tool_calls.functionobject

调用的函数。

隐藏子属性

choices.delta.tool_calls.function.argumentsstring

choices.delta.tool_calls.function.namestring

要调用的函数的名称。

choices.delta.tool_calls.idstring

工具调用的 ID。

choices.delta.tool_calls.typestring

工具的类型。目前仅支持 function。

choices.delta.annotationsarray

联网搜索后，模型会返回全部引用网址的注释。

隐藏子属性

模型创建的对联网搜索的调用。

隐藏子属性

choices.delta.annotations.logo_urlstring

logo网址。

choices.delta.annotations.publish_timestring

发布时间。

choices.delta.annotations.site_namestring

网站名称。

choices.delta.annotations.summarystring

总结。

choices.delta.annotations.titlestring

标题。

choices.delta.annotations.typestring

类型。

choices.delta.annotations.urlstring

网址。

choices.delta.error_messagestring

联网搜索链路的错误信息。

choices.delta.audioobject | null

如果请求输出音频，该对象将包含有关模型音频响应的数据。

隐藏子属性

choices.delta.audio.idstring

此音频响应的唯一标识符。

choices.delta.audio.datastring

模型生成的 Base64 编码音频，格式为请求中指定的格式。

choices.delta.audio.expires_atnumber | null

此音频响应过期的 Unix 时间戳（以秒为单位）。当前仅为 null。

choices.delta.audio.transcriptstring | null

模型生成的音频的文字记录。当前仅为 null。

choices.finish_reasonstring | null

模型停止生成 token 的原因。如果模型到达自然停止点或提供的停止序列，则为 stop；如果达到请求中指定的最大 token 数，则为 length；如果模型调用了工具，则为 tool_calls。如果内容因触发过滤策略而被拦截，则为 content_filter；如果模型检测到了复读，则为 repetition_truncation。

choices.indexinteger

选项列表中对应选项的索引。

createdinteger

对话补全对象创建时的 Unix 时间戳（以秒为单位）。每个数据块均使用相同的时间戳。

idstring

对话补全对象的唯一标识符。每个数据块均使用相同的 ID。

modelstring

用于生成结果的模型。

objectstring

对象类型，仅为 chat.completion.chunk。

usageobject | null

该对话补全请求的用量信息。

隐藏子属性

usage.completion_tokensinteger

模型输出内容花费的 token。

usage.prompt_tokensinteger

提示词使用的 token 数量。

usage.total_tokensinteger

请求中使用的 token 总数（提示词 + 补全结果）。

usage.completion_tokens_detailsobject

补全中使用的 token 数量明细。

隐藏子属性

usage.completion_tokens_details.reasoning_tokensinteger

模型为推理生成的 token 数量。

usage.prompt_tokens_detailsobject

提示中使用的 token 数量明细。

隐藏子属性

usage.prompt_tokens_details.cached_tokensinteger

缓存中提供的 token 数量。

usage.prompt_tokens_details.audio_tokensinteger

提示中存在的音频输入 token 数量。

usage.prompt_tokens_details.image_tokensinteger

提示中存在的图像输入 token 数量。

usage.prompt_tokens_details.video_tokensinteger

提示中存在的视频输入 token 数量。

usage.web_search_usageobject

联网搜索 api 的调用量明细。

隐藏子属性

usage.web_search_usage.tool_usageinteger

联网搜索 api 的调用次数。

usage.web_search_usage.page_usageinteger

联网搜索 api 返回的网页数。

curl --location --request POST 'https://api.xiaomimimo.com/v1/chat/completions' \
--header "api-key: $MIMO_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "mimo-v2.5-tts",
    "messages": [
        {
            "role": "user",
            "content": "Bright, bouncy, slightly sing-song tone — like you are bursting with good news you can barely hold in. Fast pace, rising pitch at the end."
        },
        {
            "role": "assistant",
            "content": "Hey boss — guess what, guess what? I just got the results back and I actually passed! Not just passed, I got a distinction! I know, I know — you told me I was cutting it close, but hey, here we are. Drinks are on me tonight, okay?"
        }
    ],
    "audio": {
        "format": "wav",
        "voice": "mimo_default"
    }
}'

响应

{
    "id": "6ebed286b58546f6b87fa7fa9d0e806b",
    "choices": [
        {
            "finish_reason": "stop",
            "index": 0,
            "message": {
                "content": "",
                "role": "assistant",
                "audio": {
                    "id": "979a91904f9a4143928d9e1f54837b4f",
                    "data": "base64Data",
                    "expires_at": null,
                    "transcript": null
                },
                "tool_calls": null
            }
        }
    ],
    "created": 1776954802,
    "model": "mimo-v2.5-tts",
    "object": "chat.completion",
    "usage": {
        "completion_tokens": 97,
        "prompt_tokens": 213,
        "total_tokens": 310,
        "completion_tokens_details": {
            "reasoning_tokens": 0
        },
        "prompt_tokens_details": {
            "cached_tokens": 109
        }
    }
}

curl --location --request POST 'https://api.xiaomimimo.com/v1/chat/completions' \
--header "api-key: $MIMO_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
    "model": "mimo-v2.5-pro",
    "messages": [
        {
            "role": "system",
            "content": "You are MiMo, an AI assistant developed by Xiaomi. Today is date: Tuesday, December 16, 2025. Your knowledge cutoff date is December 2024."
        },
        {
            "role": "user",
            "content": "please introduce yourself"
        }
    ],
    "max_completion_tokens": 1024,
    "temperature": 1.0,
    "top_p": 0.95,
    "stream": false,
    "stop": null,
    "frequency_penalty": 0,
    "presence_penalty": 0,
    "thinking": {
        "type": "disabled"
    }
}'

响应

{
    "id": "8b51f9e0515949cb8207fbd35ea6ea5c",
    "choices": [
        {
            "finish_reason": "stop",
            "index": 0,
            "message": {
                "content": "Hello! I'm MiMo, Xiaomi's AI assistant created by the Xiaomi LLM-Core team. I'm here to chat, help answer questions, and assist with various tasks—whether it's providing information, brainstorming ideas, or just having a friendly conversation. Feel free to ask me anything, and I'll do my best to help! 😊",
                "role": "assistant",
                "tool_calls": null
            }
        }
    ],
    "created": 1776848906,
    "model": "mimo-v2.5-pro",
    "object": "chat.completion",
    "usage": {
        "completion_tokens": 72,
        "prompt_tokens": 57,
        "total_tokens": 129,
        "completion_tokens_details": {
            "reasoning_tokens": 0
        },
        "prompt_tokens_details": null
    }
}