开发指南
第一条 API 请求:用 curl 验证模型与文本生成
使用模型列表和 Chat Completions 的最小 curl 示例验证本站 API,明确环境变量、模型 ID、响应与计费。
准备环境变量#
以下示例使用 macOS/Linux 终端的 curl。先在控制台创建 API Key,并确认有可用余额。所有示例中的密钥和模型都是占位值,需自行替换;不要把完整密钥提交到仓库。
bash
export AI_ROUTER_API_BASE='https://9weisc.cn/v1'
export AI_ROUTER_API_KEY='sk-ar-请替换为你的完整密钥'生产程序建议通过环境变量或密钥管理系统注入真实密钥。接入测试不要使用网站登录密码。
第一步:读取账户模型列表#
bash
curl --fail-with-body --silent --show-error \
"$AI_ROUTER_API_BASE/models" \
-H "Authorization: Bearer $AI_ROUTER_API_KEY"成功时返回 data 列表。选择当前账户可使用且适合文本请求的精确 id;展示名称和品牌名不能代替它。模型列表是只读接口,但生成仍需核对余额、协议和权限。
第二步:发起一条短文本#
将下方 JSON 中的 YOUR_MODEL_ID 替换为上一步的真实模型 ID,保留较小的输出上限。
bash
curl --fail-with-body --silent --show-error \
"$AI_ROUTER_API_BASE/chat/completions" \
-H "Authorization: Bearer $AI_ROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "请用两句话解释会议纪要的作用。"}],
"max_tokens": 256,
"stream": false
}'这一步是生成请求,会按平台规则计费。OpenAI 兼容文本响应通常在 choices[0].message.content 中包含结果,并可能包含 usage;具体字段受模型协议影响。
第三步:核对用量#
在用量明细查找对应时间和模型。如果要记录响应头,curl 加上 -i,保留 X-Request-ID 帮助排查。
读取到模型列表仅说明这条只读请求通过,不能作为已经完成生成或全部高级功能兼容的证据。
遇到错误怎么办#
401 检查密钥,402 检查余额,403 检查授权和白名单,404 检查路径和模型。429/容量 503 按 Retry-After 等待;502 或网络中断不要无条件重放付费 POST,请先核对原请求状态。
旧版本 curl 如果不支持 --fail-with-body,可去掉此选项并使用 -i 查看响应状态,不要只根据终端是否有文字判断成功。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。