API 文档

智优 MaaS 提供与 OpenAI 完全兼容的 RESTful 接口，你现有的 OpenAI SDK 无需改造即可直接接入。 下文示例中的 <你的服务器域名> 即当前站点地址，已为你自动填充。

一、快速接入

Base URL	https://zymaas.com/v1
认证方式	Authorization: Bearer <你的 sk- 密钥>
协议	完全兼容 OpenAI API 格式（chat / models）
密钥获取	登录后进入「API 令牌」页，查看并复制主令牌；每个令牌可单独设置「允许调用的模型」

二、对话补全（Chat Completions）

POST https://zymaas.com/v1/chat/completions

curl -X POST https://zymaas.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "deepseek-v4-flash-0731",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

Python（OpenAI SDK）：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://zymaas.com/v1"
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

• 支持 stream: true 返回 SSE 流式结果，与 OpenAI 标准一致。
• 支持 tools / tool_choice、temperature、top_p、max_tokens 等标准参数。
• 计费按 输入 token × 输入价 + 输出 token × 输出价 实时从余额扣除；价格见「可用模型与定价」页。

三、获取可用模型列表

GET https://zymaas.com/v1/models（返回当前令牌允许调用的模型）

curl https://zymaas.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

四、常见返回码

HTTP 状态	含义	处理建议
200	成功	—
401	密钥无效 / 未带 Authorization	检查 Bearer 头与 sk- 密钥是否正确
402	余额不足（insufficient_quota）	登录控制台充值后重试
403	该令牌未授权此模型（model not allowed）	在「API 令牌」页「允许模型」中确认，或联系管理员
404	该模型暂无可用上游渠道（no channel）	联系管理员在「渠道管理」启用对应渠道
429	触发限流	降低并发或稍后重试