API 使用详解

AIRouter 使用 OpenAI 兼容接口。接入时重点配置 Base URL、API Key 和模型 ID。

基础信息

项目	值
Base URL	https://aigc.aochengcloud.com/v1
认证	Authorization: Bearer YOUR_API_KEY
请求格式	Content-Type: application/json

查询模型

调用前先查询当前 API Key 可用模型：

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

响应中的 data[].id 用于后续请求的 model 字段。

聊天补全

非流式请求

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
  }'

流式请求

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": true
  }'

响应字段

字段	说明
id	请求 ID
model	实际调用的模型
choices	模型输出
usage	token 用量

Python SDK

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 SDK

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);

其他接口

接口	路径	说明
文本补全	/v1/completions	旧式 completions 接口，取决于模型是否支持
文本嵌入	/v1/embeddings	向量接口，取决于模型是否支持
图像生成	/v1/images/generations	图像生成接口，取决于站点和模型配置

排查建议

问题	检查项
401	API Key 是否正确、启用、未过期
403	模型权限、账号分组、API Key 的 Model Limits
404	Base URL 是否重复或缺少 /v1
429	请求频率是否过高
余额不足	钱包余额和 API Key 额度
模型不存在	重新查询 /v1/models

查看日志

调用后进入「使用日志」页面查看请求详情：

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

日志是排查上游错误、余额不足、模型权限和参数错误的主要依据。