快速开始：5 分钟发出第一次请求
从注册到第一次调用：创建 API Key、替换 base_url、选择模型，以及 OpenAI / Claude / Gemini 三种协议的最小可运行示例。
1. 创建 API Key
新账号自带测试额度，可直接跑通下面的示例。
2. 记住你的端点
| 协议 | Base URL | 适用场景 |
|---|---|---|
| OpenAI 兼容 | https://api.zaimod.com/v1 | 绝大多数 SDK、插件、客户端 |
| Anthropic 原生 | https://api.zaimod.com | Claude 全特性（thinking、原生工具） |
| Gemini 原生 | https://api.zaimod.com/v1beta/models/{model}:generateContent | Gemini 原生特性 |
拿不准就用 OpenAI 兼容端点——它是所有工具的默认选项。
3. 发出第一个请求
Python
pip install openaifrom openai import OpenAI
client = OpenAI(
api_key="sk-your-zaimod-key",
base_url="https://api.zaimod.com/v1",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(resp.choices[0].message.content)
print(resp.usage) # 本次调用的 token 计量Node.js
npm install openaiimport OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ZAIMOD_API_KEY,
baseURL: "https://api.zaimod.com/v1",
});
const res = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Explain API gateways in 3 sentences." }],
});
console.log(res.choices[0].message.content);cURL
curl https://api.zaimod.com/v1/chat/completions \
-H "Authorization: Bearer $ZAIMOD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-lite-preview",
"messages": [{"role": "user", "content": "Hello!"}]
}'4. 换模型 = 换模型名
同一个端点，改 model 参数即可跨厂商：
- OpenAI：
gpt-4o-mini、gpt-4.1、gpt-5.6-terra - Claude：
claude-sonnet-5、claude-opus-4-7 - Gemini：
gemini-3.1-flash-lite-preview、gemini-3.1-pro-preview - DeepSeek：
deepseek-v4-flash - 国产：
qwen3.5-plus、doubao-seed-2-0-pro-260215、glm-5.2
5. 常用参数速查
| 参数 | 说明 |
|---|---|
stream: true | SSE 流式输出，打字机效果 |
max_tokens | 限制输出长度，控成本的第一杠杆 |
temperature | 0–2，越低越确定 |
tools | 函数调用 / 工具使用 |
response_format | {"type": "json_object"} 结构化输出 |
下一步
跑不通时先看响应体里的错误码：401 是 Key 问题，404 是模型名拼错，429 是限流。