DOCS · 接入文档

快速开始

三分钟跑通第一次调用。已有 OpenAI 接入的项目，只需替换 Base URL 与密钥。

第一步：创建令牌

注册登录后进入控制台，打开「令牌」页，点击「新建令牌」，按需设置名称、额度与过期时间，保存后复制以 sk- 开头的密钥。

第二步：设置接口地址

将 API 的 Base URL 设置为：

https://agisaas.cn/v1

第三步：发起调用

curl https://agisaas.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "<模型名>",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://agisaas.cn/v1",
)

resp = client.chat.completions.create(
    model="<模型名>",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

注意事项

模型名以模型广场与控制台公示为准，切换模型只需修改 model 参数。
令牌（API Key）可设置额度上限、过期时间与 IP 白名单，建议按应用分别创建。
接口兼容 OpenAI Chat Completions 协议，支持流式输出（stream: true）。
请妥善保管令牌，泄露后请立即在控制台吊销并新建。

兑换码使用

通过官方活动或商务合作获得兑换码后，按以下步骤兑换额度：

1.登录控制台，打开「钱包」页面。
2.在「兑换」输入框中粘贴兑换码，点击兑换。
3.额度实时到账，可在余额与日志中核对。

常见问题

调用返回 401 / 令牌无效？

检查令牌是否复制完整（sk- 开头）、是否已过期或被吊销；确认请求头格式为 Authorization: Bearer sk-你的令牌。

调用返回余额不足？

控制台「钱包」页充值或使用兑换码补充额度后即时恢复；也可为单个令牌检查是否设置了额度上限。

模型名报错或不可用？

模型名必须与模型广场公示完全一致（区分大小写与符号）；部分模型可能因上游维护临时不可用，可切换同类模型。

平台会留存我的对话数据吗？

除计费核对与合规审计所必需的调用日志（模型名、Token 用量、耗时、状态）外，平台不留存、不审阅提示词与生成内容，不将其用于模型训练。

支持哪些发票？

支持增值税普通发票与专用发票，充值后即可申请开具；赠送与兑换码额度部分不开具发票。

遇到问题？

先检查令牌是否有效、余额是否充足、模型名是否与公示一致。调用记录与费用明细可在控制台「日志」页逐条核对；仍无法解决，请来信 support@hi-hub.cn。