快速开始

ModelServer 是一个 OpenAI 兼容的统一 API,一把 Key 调通 Claude、GPT、Gemini、DeepSeek 等 40+ 模型。如果你已经在用 OpenAI SDK,把 base URL 改一下就能跑。

在 ModelServer 控制台创建一个 API Key,然后在你熟悉的 SDK 里把base_url指向 https://modelserver.dev/v1。下面三种语言的代码完全等价,选你最顺手的:

curl https://modelserver.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4",
    "messages": [
      {"role": "user", "content": "你好,请用一句话介绍你自己"}
    ]
  }'

所有响应字段、流式分块、tool calls、response_format、multimodal 都和 OpenAI 官方 API 一致 — 也就是说,你**不需要重写**任何业务代码,直接复用 OpenAI SDK 的任何高级特性。

想试免费模型?

在控制台「模型」页面筛选「Free」标签,这些模型 0 费率(由上游赞助),适合开发期试错。生产建议直接用付费版。

切换模型只改一个参数

所有模型共享同一套 messages 接口。要换模型,只改 model 参数即可,业务代码不需要任何修改。常用的几个 ID:

model 参数

# Anthropic Claude
"claude-opus-4"          # 旗舰款,推理 / 写作最强
"claude-sonnet-4"        # 性价比之选,日常首选
"claude-3-5-haiku"       # 最快最便宜

# OpenAI
"gpt-5.2"                # 旗舰款
"gpt-4o"                 # 速度 / 质量平衡
"o1-mini"                # 小型推理模型

# Google
"gemini-2.5-pro"         # 长上下文(2M tokens)
"gemini-2.5-flash"       # 快、便宜

# DeepSeek
"deepseek-r1"            # 强推理,开源
"deepseek-v3"            # 通用对话

完整的模型列表和价格在定价页。所有调用按上游官方价 1:1 透传,只在充值时收一次 5.5% 平台费,**调用本身不再扣费**。

下一步

想把 Claude Code、Cursor、Cline 等命令行 / IDE 客户端接到 ModelServer?直接看安装 Claude Code,3 分钟把你的开发环境切过来。其他客户端的接入文档会陆续放在「集成」分组下。