跳转到内容
Mirobody
Get Started

开始使用

模型

GET /v1/models —— 列出可用的能力档。

端点

Section titled “端点”
GET /v1/models

列出你可以作为 model 传给 Answers API 与 Agent API 的能力档。形状兼容 OpenAI。

能力档

Section titled “能力档”
model档位适用场景
mirobody-flash默认 —— 快速、低成本日常健康问答、高并发
mirobody-expert更深入的推理复杂报告解读、多步分析

托管模型用量按底层提供方返回的 token 数计量。每次模型响应都包含 usage.billed_tokens，把它与当前模型目录里的 pricing 结合起来即可估算费用。控制台的用量页展示请求数，不提供 token 级费用。开源引擎是免费软件 —— 自托管时你只需承担自己的基础设施与 LLM 提供方费用。

每档元数据

Section titled “每档元数据”

每个条目携带一个保守的容量预算与该档单价：

字段含义
context_window该能力档公布的输入与输出总容量。它用于容量规划，不保证任意请求形态都能占满。
max_output_tokens公布的输出容量 —— 仅为模型目录元数据；agent 模式不会强制执行 max_tokens 等请求字段。
pricing{input_per_1m_tokens, output_per_1m_tokens, currency} —— 用于结合 usage.billed_tokens 估算的每 1M tokens 标准单价；该对象不体现缓存调整。

示例

Section titled “示例”
Terminal window
# 无需 API key
curl https://api.mirobody.ai/v1/models
from openai import OpenAI


# /v1/models 不使用 api_key，但 SDK 要求该字段有值
client = OpenAI(api_key="unused", base_url="https://api.mirobody.ai/v1")
for m in client.models.list().data:
    print(m.id)

响应

Section titled “响应”

一个 OpenAI 风格的 { "object": "list", "data": [ … ] } —— 每个档位在标准 model 对象上扩展 context_window、max_output_tokens 与 pricing。以下数值用于展示响应形状；当前值应以实时端点为准：

{
  "object": "list",
  "data": [
    { "id": "mirobody-flash", "object": "model", "owned_by": "mirobody",
      "context_window": 65536, "max_output_tokens": 8192,
      "pricing": { "input_per_1m_tokens": 0.75, "output_per_1m_tokens": 4.50, "currency": "USD" } },
    { "id": "mirobody-expert", "object": "model", "owned_by": "mirobody",
      "context_window": 65536, "max_output_tokens": 8192,
      "pricing": { "input_per_1m_tokens": 5.0, "output_per_1m_tokens": 25.0, "currency": "USD" } }
  ]
}

model 请始终传入稳定的能力档 —— mirobody-flash（默认）或 mirobody-expert。