API 文档
接口参考

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 计费:输入、输出分别计价,缓存命中的输入按折扣价结算。每次调用前按最大成本预占额度、结束后按实际用量结算;余额与每笔账单可在控制台「用量与账单」核对。