跳到正文
九维AI开放平台使用文档

开发指南

第一条 API 请求:用 curl 验证模型与文本生成

使用模型列表和 Chat Completions 的最小 curl 示例验证本站 API,明确环境变量、模型 ID、响应与计费。

成都九维数创科技有限公司 · 文档团队更新于 约 6 分钟阅读
本页目录
  1. 准备环境变量
  2. 第一步:读取账户模型列表
  3. 第二步:发起一条短文本
  4. 第三步:核对用量
  5. 遇到错误怎么办

准备环境变量#

以下示例使用 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 查看响应状态,不要只根据终端是否有文字判断成功。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground