发起第一次 API 调用

本页从控制台创建 API Key 开始，完成一次 OpenAI 兼容接口调用。

1. 创建 API Key

登录后进入「API Keys」页面：

https://aigc.aochengcloud.com/keys

点击「Create API Key」，按需填写：

创建 API Key 示意图

字段建议
Name填写用途，例如 dev-test、production
Group保持默认，除非管理员要求选择特定分组
Quantity通常为 1；批量创建时再增加数量
Unlimited Quota测试阶段可保持开启；生产环境建议按预算设置额度
Quota关闭无限额度后填写该 Key 可用额度
Expiration Time临时测试 Key 建议设置过期时间
Model Limits留空表示允许全部可用模型；生产环境可限制模型
IP Whitelist有固定出口 IP 时再填写，每行一个 IP 或 CIDR

保存后复制 API Key。密钥是接口调用凭证，请不要提交到代码仓库或公开聊天记录。

第一次创建怎么填

只做测试时，Name 填 dev-test，Unlimited Quota 保持开启，Model Limits 留空，保存后复制 API Key 即可。

2. 查询可用模型

也可以先在控制台「模型」页面复制模型 ID：

模型页面示意图

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

响应中 data[].id 就是调用时可填写的模型 ID。

示例：

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "owned_by": "vertex-ai"
    }
  ]
}

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. 使用 SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    base_url="https://aigc.aochengcloud.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
)

print(response.choices[0].message.content)

Node.js

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.AIROUTER_API_KEY,
  baseURL: 'https://aigc.aochengcloud.com/v1',
});

const response = await openai.chat.completions.create({
  model: 'claude-sonnet-4-6',
  messages: [{ role: 'user', content: '你好' }],
});

console.log(response.choices[0].message.content);

5. 查看日志

调用后进入「使用日志」页面：

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

可查看请求时间、模型、状态、消耗、错误信息等。排查 401、余额不足、模型不可用等问题时，优先查看这里。

使用日志示意图

常见错误

状态常见原因处理方式
401API Key 错误、被禁用或已删除重新复制 Key，确认 Key 状态为启用
403当前账号或 Key 无权访问模型换用可用模型，或联系管理员开通权限
429请求过快或命中限速降低并发，稍后重试
余额不足钱包额度不足或 Key 额度耗尽充值兑换，或调整 Key 额度
模型不存在模型 ID 填写错误或已下线重新查询 /v1/models

下一步

API Key 管理 →查看模型 CLI 接入 →
最后更新: