如何使用 Model Gate

快速开始

三分钟跑通一次对话。

1. 登录 控制台，在 API Key 页面新建一把密钥并复制保存。
2. 打开 模型列表，记下要用的模型名称（例如 gpt-4o 这类 slug）。
3. 把下面示例里的 YOUR_API_KEY 和 your-model-slug 换成你的真实值，运行即可。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://model-gate.lawmeta.top/api/v1",
  apiKey: process.env.MODEL_GATE_API_KEY,
});

const completion = await client.chat.completions.create({
  model: "your-model-slug",
  messages: [
    { role: "user", content: "你好，介绍一下你自己" }
  ],
});

console.log(completion.choices[0].message.content);

切换标签查看不同语言；内容等价，任选其一即可。想在 Cursor 等工具里用？见 在常用工具里用。

在常用工具里用

下面以 Cursor、Hermes Agent、Open Claw 为例。三者都支持 OpenAI 兼容接口，按卡片里的步骤填服务地址、API Key 和模型名称即可。

接口参数

OpenAI 对话：POST https://model-gate.lawmeta.top/api/v1/chat/completions。Claude Code 等使用 Anthropic Messages：POST https://model-gate.lawmeta.top/api/v1/messages（鉴权可用 Bearer 或 x-api-key）。下文参数表以 Chat Completions 为主。

请求头

请求体字段

{
  "model": "your-model-slug",
  "messages": [
    { "role": "system", "content": "你是一个简洁的助手" },
    { "role": "user", "content": "你好" }
  ],
  "temperature": 0.7,
  "max_tokens": 1024,
  "stream": false
}

messages 消息结构

messages 为对象数组，每条消息包含：

多轮对话按时间顺序排列即可：先 system（可选），再交替 user 与 assistant。

流式相关

• 设置 stream: true 后，响应为 SSE（text/event-stream），按 data: 行推送，以 data: [DONE] 结束。
• 流式请求时平台会自动带上用量统计配置，便于在流结束后按 token 扣费；客户端无需自行配置 stream_options。

curl https://model-gate.lawmeta.top/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-slug",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

长对话可适当控制 max_tokens，避免余额预检时预估费用过高。

响应体（非流式）

HTTP 200 时，JSON 主体常见字段如下（具体以上游返回为准）：

响应头

怎么选模型

所有可用模型、参考价格和上下文长度，都在模型列表页维护。

请打开 模型列表 浏览。调用时把列表里的模型名称原样复制到请求的 model 字段，不要自己改写或缩写。

程序里需要自动拉列表时，可请求 GET /models（需带 API Key），返回里的 id 就是调用时要填的名称。

遇到问题

先看下面几种常见情况，大多能自行解决。

常见问题