API 接口

AIRouter 提供 OpenAI 兼容 API。大多数 OpenAI SDK、客户端和代理工具只需要把 Base URL 改为 AIRouter 地址，并使用控制台创建的 API Key。

接口概览

项目值
API Base URLhttps://aigc.aochengcloud.com/v1
认证方式Authorization: Bearer YOUR_API_KEY
内容类型Content-Type: application/json
模型列表GET /v1/models

注意

SDK 的 base_url / baseURL 通常填写到 /v1。如果某个客户端把 /v1 作为独立字段，请按客户端说明配置，避免重复拼成 /v1/v1。

支持的常用接口

接口方法说明
/v1/modelsGET获取当前 API Key 可用模型
/v1/chat/completionsPOST聊天补全，支持流式响应
/v1/completionsPOST文本补全，供旧式补全模型使用
/v1/embeddingsPOST文本向量
/v1/images/generationsPOST图像生成，是否可用取决于模型和站点配置

认证

所有需要鉴权的请求都要带上 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

查询模型

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

响应中的 data[].id 是后续请求使用的模型 ID。

聊天补全示例

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": "你好"}
    ]
  }'

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

Go SDK

package main

import (
    "context"
    "fmt"

    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig("sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
    config.BaseURL = "https://aigc.aochengcloud.com/v1"

    client := openai.NewClientWithConfig(config)

    resp, err := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model: "claude-sonnet-4-6",
            Messages: []openai.ChatCompletionMessage{
                {
                    Role:    openai.ChatMessageRoleUser,
                    Content: "你好",
                },
            },
        },
    )
    if err != nil {
        fmt.Printf("ChatCompletion error: %v\n", err)
        return
    }

    fmt.Println(resp.Choices[0].Message.Content)
}

错误码说明

HTTP 状态码常见原因处理方式
400请求参数错误检查 JSON、模型 ID 和接口路径
401API Key 无效重新复制 Key，确认 Key 未删除或禁用
403权限不足确认账号、分组和模型权限
404接口或资源不存在检查 Base URL 是否配置正确
429请求过快降低并发或稍后重试
500/503服务或上游异常查看使用日志，稍后重试或联系售后

详细接口文档

聊天补全接口 →文本补全接口 →文本嵌入接口 →图像生成接口 →
最后更新: