DOCS

接入文档

面向首次接入的开发者。注册并创建密钥后，把代码中的接口地址和密钥替换即可。

1. 接口地址

接口网关部署在 may.ailzd.com，base URL 为：

https://may.ailzd.com/v1

2. 协议兼容性

POST /v1/chat/completions：OpenAI 兼容
POST /v1/messages：Anthropic 兼容
GET /v1/models：查询当前密钥可用的模型

兼容上述协议的 SDK 与客户端通常只需修改 base URL 与密钥即可使用，具体特性支持情况以实际调用为准，建议先小流量验证。

3. 鉴权

使用 Bearer Token。密钥在控制台「API 密钥」页创建，可随时吊销：

Authorization: Bearer YOUR_API_KEY

4. 调用示例

curl https://may.ailzd.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_NAME","messages":[{"role":"user","content":"你好"}]}'

from openai import OpenAI
client = OpenAI(base_url="https://may.ailzd.com/v1", api_key="YOUR_API_KEY")
resp = client.chat.completions.create(
    model="MODEL_NAME",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

其中 MODEL_NAME 请替换为控制台中您的密钥可用的模型名称。

5. 线路与模型

每条线路绑定一组模型与倍率，创建密钥时选择所属线路。各厂商倍率范围见价格，可用模型以控制台为准。

6. 用量与账单

每次调用的 token 用量与费用可在控制台「使用记录」中查看。
余额随调用实时扣减，不足时调用将被拒绝，请及时充值。

7. 常见错误码

状态码	含义	建议处理
401	密钥无效、缺失或已吊销	检查 Authorization 请求头，必要时重建密钥
403	当前密钥无权使用该模型或线路	核对密钥所属线路与模型
429	触发并发或频率限制	退避重试；需要提高限额请联系客服
502	上游线路暂时异常	稍后重试或更换线路

8. 使用建议

不同业务使用独立密钥，便于分摊用量与吊销。
先以小流量验证模型与功能的兼容性，再全量切换。
请勿在提示词中提交敏感个人信息或涉密内容，原因见隐私政策。