model-api-reference — 主流大模型 API 接入参考

概述

收录 8 个主流大模型 API 提供平台的接入要点，全部整理自各厂商官方文档（采集日期 2026-10-13）。每个平台一个参考文档，放在 references/ 下，按需加载，不要一次全读。

平台总览

以上平台的 chat completions 认证统一为 Authorization: Bearer <API_KEY>（MiMo 还支持 api-key 头，二选一）。

使用指南

1. 通用调用模式

除特别注明外，所有平台都兼容 OpenAI Chat Completions 协议，用 OpenAI SDK 改 base_url 即可：

from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepseek.com",      # 换成目标平台 Base URL（见总览表/各参考文档）
    api_key="<平台 API Key>",
)
resp = client.chat.completions.create(
    model="deepseek-flash",                   # 换成目标模型 ID
    messages=[{"role": "user", "content": "你好"}],
    temperature=0.7,
    tools=[{                                  # function calling，按需
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "查询城市天气",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"],
            },
        },
    }],
)
print(resp.choices[0].message)

Base URL 是否带 /v1 不统一，是最常见的踩坑点：DeepSeek、GLM 不带；百炼、火山方舟、阶跃、MiMo、opencode 带。各家 temperature 范围和默认值也不同（如 GLM 是 [0,1]，DeepSeek/阶跃上限 2.0，MiMo 上限 1.5），调用前查对应文档。

2. 选型速查

• 免费/低成本：GLM 有常驻免费模型（glm-4.7-flash 等）；百炼新用户每模型约 100 万 token 免费额度（90 天）；火山方舟新用户 50 万 token 体验额度；opencode zen 有一批限时免费模型（但仅限 opencode 客户端内调用，外部调用返 403 FreeTierError）。
• 超长上下文：qwen-long 10M；DeepSeek-flash / GLM-5.3 / MiMo-v2.6 / 豆包 seed 2.1 均为 1M。
• 推理/思考模型：各家都支持，但开关写法各不相同（thinking.type / enable_thinking / reasoning_effort），且与 temperature、tool_choice 常有互斥，见各文档"思考模式"一节。
• 聚合网关：opencode zen/go 用一个 Key 调 Claude/GPT/Grok/Kimi/GLM/DeepSeek/Qwen 等 80+ 模型，适合客户端产品接入。

3. 跨平台通用注意事项

• 思考模式互斥：DeepSeek 思考模式下 tool_choice=required 或指定函数返回 400；MiMo 思考模式强制 temperature=1.0/top_p=0.95；GLM-5.3/5.3-Flash 不可关闭思考。
• 多轮回传：工具调用后回传 role:"tool" + tool_call_id；思考模型多轮需回传 reasoning_content（GLM 设 clear_thinking:false 时尤其注意），否则可能 400 或丢上下文。
• 流式：stream=true 时 stream_options.include_usage 可拿 token 用量（DeepSeek 在 stream=false 时传该字段会 400）；流式工具调用需拼接 delta.tool_calls。
• 计费单位：均为元（或美元）/百万 tokens，区分输入/输出/缓存命中三档；DeepSeek、GLM 等有上下文缓存自动或显式命中折扣。

参考文档目录

时效性声明

本技能内容采集于 2026-10-13。模型上下架、价格、限流、免费额度规则变动频繁（如 MiMo v2.5 系已公告 2026-10-21 下线，阶跃 step-5-preview 缓存价 2026-10-14 起调整），关键决策前请以各参考文档末尾的官方文档链接在线核对。文档中标注"未找到"的信息表示官方文档未公布，不要臆造。