Absolutely / PoloAPI 使用
完全指南
这是一份面向普通用户与开发者的详细使用文档。本文将带你完成从 注册登录、充值余额、创建密钥、选择模型 到 调用 API 的完整流程，适合作为你的文档首页与新手入口页。
“如果你是第一次使用，只需要先看 快速开始 这一节。按照顺序做完 4 步后， 就可以开始在 Cherry Studio、OpenAI SDK、Claude 兼容工具或你自己的程序里直接调用。”
目录
- 1. 快速开始
- 2. 充值余额
- 3. 创建 API Key
- 4. 选择模型名称
- 5. 发起接口请求
- 6. 计费与分组说明
- 7. 常见问题
快速开始
第一次接入时，建议你按下面 4 步操作。整个过程通常只需要几分钟。
充值余额
登录控制台后，先进入左侧的 钱包管理 页面完成充值。 接口调用会从账户余额中扣费，所以余额需要大于 0。
创建 API Key
进入左侧 令牌管理，点击“添加令牌”，创建你的接口密钥。 创建完成后复制密钥，并妥善保存，后续请求都需要带上它。
选择调用模型
在 模型广场 查看支持的模型名称、价格与分组要求。 请求里的 model 字段必须和站内展示的模型名一致，不要自己改写。
发起请求
使用 Base URL + 你的 API Key 发起请求。本站兼容常见 OpenAI 风格调用方式， 可直接接入大多数支持 OpenAI 接口格式的客户端或程序。
1. 充值余额
登录控制台后，点击左侧导航栏的 钱包管理。你会看到当前余额、历史消费和相关账单信息。
普通用户怎么充值
进入钱包页面，选择在线充值或管理员开放的支付方式，按提示完成即可。
为什么先充值
大模型调用是按量计费的。没有余额时，请求可能会被拒绝，或者返回余额不足相关提示。
建议第一次先少量充值，确认自己需要使用的模型和客户端都接入正常后，再按使用量逐步补充余额。
2. 创建 API Key
在左侧进入 令牌管理，点击“添加令牌”。 你可以设置令牌名称、额度上限、所属分组、是否允许聊天等权限。
- 进入控制台 → 令牌管理
- 点击“添加令牌”
- 填写名称，选择对应分组
- 按需设置额度或无限额度
- 保存后复制生成的密钥
Authorization: Bearer sk-your-key
3. 选择调用模型
在 模型广场 中可以查看当前站点支持的模型、模型价格、调用说明以及是否有分组要求。
- 请求中的
model字段，必须填写站内展示的模型名称 - 不要自己省略后缀或改写模型名
- 如果某些模型提示无权限，通常是因为你的令牌分组不匹配
- 不同模型价格不同，请先看清模型价格和倍率
| 项目 | 说明 |
|---|---|
| 模型名称 | 必须与模型广场一致，例如某个具体的 Claude / GPT / Gemini 模型名 |
| 可用分组 | 有些模型只允许特定用户分组或令牌分组调用 |
| 价格 | 按输入 / 输出 / 固定价格 / 倍率等方式计费，以站内显示为准 |
| 特殊说明 | 某些模型可能有图片输入、缓存、搜索等附加计费项目 |
4. 发起接口请求
下面给你一个最常见的 OpenAI 风格请求示例。你只需要替换掉：
Base URLsk-your-keymodel
curl https://api.fengsuan.online/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-key" \
-d '{
"model": "gpt-4.1-mini",
"messages": [
{
"role": "user",
"content": "你好，请返回一句欢迎语"
}
]
}'
推荐填写方式
Base URL
https://api.fengsuan.online
认证方式
HTTP Header 中使用 Authorization: Bearer sk-xxx
OpenAI SDK 示例（Python）
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.fengsuan.online/v1"
)
resp = client.chat.completions.create(
model="gpt-4.1-mini",
messages=[
{"role": "user", "content": "你好，请介绍一下你自己"}
]
)
print(resp.choices[0].message.content)
5. 计费与分组说明
本站的计费通常由以下几个因素共同决定：
- 你调用的模型本身价格
- 所在分组倍率
- 是否有补全倍率 / 图片倍率 / 缓存倍率
- 是否为按次收费模型
分组的作用是控制：
- 哪些模型你能用
- 不同分组的价格倍率
- 令牌是否允许访问对应模型
6. 常见问题
Q1：返回“余额不足”怎么办？
先去钱包管理确认账户余额是否足够，再检查令牌本身是否单独设置了额度限制。
Q2：为什么模型调用失败，说模型不存在？
多半是因为你填写的 model 名称和模型广场展示的不一致。请直接复制站内模型名，不要手改。
Q3：为什么某些模型能在控制台看到，但令牌调用不了？
因为令牌可能绑定了分组限制，而该模型只允许特定分组访问。请检查令牌分组与模型分组要求。
Q4：第三方客户端怎么填？
一般只需要填：
- 接口地址：
https://api.fengsuan.online/v1 - API Key：你创建的
sk-xxx - 模型名：站内模型广场中的名称
Q5：请求成功了，但扣费看起来不对？
请先到使用日志中查看该次请求的详细计费说明，里面会显示模型价格、倍率、输入输出 token 等信息。