第一次 API 调用

本页只保留从 API Key 到调用成功的必要步骤。

1. 设置 API Key

在终端中设置环境变量：

export AIROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Windows PowerShell：

$env:AIROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

2. 查询模型

curl https://aigc.aochengcloud.com/v1/models \
  -H "Authorization: Bearer $AIROUTER_API_KEY"

从返回结果中复制 data[].id，后续填到 model 字段。

3. 调用聊天接口

curl https://aigc.aochengcloud.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ],
    "stream": false
  }'

4. 查看日志

打开：

https://aigc.aochengcloud.com/usage-logs

如果请求失败，优先看日志中的状态码和错误信息。

常见处理

问题	处理
401	重新复制 API Key，确认没有多余空格
403	换用账号可用模型，或检查 API Key 的模型限制
429	降低请求频率后重试
余额不足	先到钱包充值兑换
模型不存在	重新查询 /v1/models