接口参考
API 文档
Relay 兼容 OpenAI Chat Completions 协议:把 baseURL 指向 https://m.zmzai.cloud/v1,用 API Key 鉴权即可。zcode、codex 等第三方工具直接使用此地址。模型与价格见 模型列表。
1. 鉴权
在控制台创建 API Key 后,通过 Authorization: Bearer <YOUR_API_KEY> 请求头传入。Key 可随时吊销,每次调用按 token 实时计费。
2. 非流式请求
curl — 非流式
$curl https://m.zmzai.cloud/v1/chat/completions \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}]}'
3. 流式请求
请求体增加 "stream": true,服务端返回 SSE 数据流,末尾的 usage 事件携带本次调用的 token 统计。
curl — 流式
$curl -N https://m.zmzai.cloud/v1/chat/completions \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-pro","stream":true,"messages":[{"role":"user","content":"你好"}]}'
4. 渠道路由
默认按模型自动选择上游渠道(失败时自动尝试下一个)。需要精确控制时,在请求体传入 "channel": "渠道名"。渠道名见模型列表的渠道列。
5. 推理强度
支持 reasoning_effort 参数(low / medium / high,各模型支持范围见模型详情页)。DeepSeek 的思考相关参数可随请求体透传。
6. 计费
按 token 计费:输入、输出分别计价,缓存命中的输入按折扣价结算。每次调用前按最大成本预占额度、结束后按实际用量结算;余额与每笔账单可在控制台「用量与账单」核对。