← 返回文档中心 🏠 访问首页

API 参考

接口文档、参数说明、多客户端接入指南

更新日期：2026-06-25
一 基本信息
参数值
API Base URLhttps://www.aoyuapi.cn/v1
认证方式Bearer Token（API Key）
API 格式完全兼容 OpenAI API 格式
Key 前缀sk-
二 兼容的客户端 / 应用

以下应用均已兼容 OpenAI API 格式，可直接对接 Sub2API：

💬
ChatBox
桌面 / 移动端聊天
💻
NextChat
Web 聊天界面
✍
Codex
AI 代码编辑器
🎭
Cherry Studio
AI 对话客户端
🔬
Open WebUI
自托管 Web 界面
💼
Cursor
AI 驱动 IDE
📊
Claude Code
终端 AI 助手
📑
LobeChat
现代化 AI 聊天
🚀
OpenAI SDK
Python / Node.js
🖨
curl
命令行测试
三 客户端配置指南

ChatBox（推荐新手）

ChatBox 是一款跨平台桌面/移动端 AI 聊天客户端。

1
下载 ChatBox：https://chatboxai.app
2
打开设置 → 自定义 API 提供商
3
填写 API 地址：https://www.aoyuapi.cn/v1
4
填写 API Key（在平台创建）
5
选择模型名称（如 deepseek-v4-flash）
ChatBox 支持文字聊天。如需图片生成或视觉识别，请通过 API 直接调用。

NextChat（网页版聊天）

平台已内置 NextChat，可直接访问 /chat/ 使用，无需额外配置。

也可自行部署 NextChat，配置方式：

1
环境变量 BASE_URL=https://www.aoyuapi.cn/v1
2
环境变量 API_KEY=sk-您的密钥
3
环境变量 MODELS=deepseek-v4-flash,deepseek-v4-pro,qwen-turbo,gpt-5.4-mini

Codex

Codex 是一款 AI 驱动代码编辑器，支持接入自定义 API。

1
打开 Codex 设置 → AI 模型
2
API 提供商选择「OpenAI 兼容」
3
API URL：https://www.aoyuapi.cn/v1
4
API Key：粘贴您的密钥
5
模型：选择 deepseek-v4-flash 或 deepseek-v4-pro

Cherry Studio

Cherry Studio 是一款美观的 AI 对话客户端。

1
打开 Cherry Studio 设置
2
添加自定义 API 端点
3
填写 API 地址：https://www.aoyuapi.cn/v1
4
填写 API Key
5
添加模型列表（如 deepseek-v4-flash, qwen-plus, gpt-5.4-mini）

Open WebUI

自托管 Web UI，支持 Ollama 和 OpenAI 兼容接口。

1
Open WebUI 管理面板 → 设置 → 外部连接
2
添加 OpenAI 兼容 API
3
API URL：https://www.aoyuapi.cn/v1
4
API Key：粘贴您的密钥
部分自部署工具需要配置 CORS 或 proxy，确保可正常访问 API 地址。

Cursor AI IDE

Cursor 支持自定义 OpenAI 兼容 API 供 AI 代码补全和聊天使用。

1
Cursor 设置 → Models → OpenAI Compatible
2
API Base URL：https://www.aoyuapi.cn/v1
3
API Key：粘贴您的密钥
4
模型：deepseek-v4-flash（推荐代码任务）

Claude Code（终端）

Claude Code 是 Anthropic 官方的终端 AI 编程助手，可配置使用 OpenAI 兼容接口。

export ANTHROPIC_BASE_URL=https://www.aoyuapi.cn/v1
export ANTHROPIC_API_KEY=sk-您的密钥
# 在 claude_code 配置中设置 model 为支持的最新模型
注意：Claude Code 默认使用 Anthropic 格式，需确认兼容性。推荐使用 Python/Node.js SDK 直接调用。

LobeChat

现代化 AI 聊天框架，支持插件和多种模型接入。

1
LobeChat 设置 → 自定义模型服务商 → OpenAI
2
代理地址：https://www.aoyuapi.cn/v1
3
API Key：粘贴您的密钥
四 API 调用示例

curl（免费模型）

curl https://www.aoyuapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-您的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

curl（付费模型）

curl https://www.aoyuapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-您的ChatGPT密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://www.aoyuapi.cn/v1",
    api_key="sk-您的密钥"
)

# 免费模型
response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

# 付费模型（ChatGPT-Plus）
response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://www.aoyuapi.cn/v1',
  apiKey: 'sk-您的密钥'
});

const response = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [{ role: 'user', content: '你好' }]
});
console.log(response.choices[0].message.content);

列出可用模型

curl https://www.aoyuapi.cn/v1/models \
  -H "Authorization: Bearer sk-您的密钥"
所有 API 端点均兼容 OpenAI 官方格式。将 base_url 替换为 https://www.aoyuapi.cn/v1 即可在现有 OpenAI 代码中无缝切换。
五 可用模型列表
模型名所属渠道价格
deepseek-v4-flashDeepSeek 上游免费
deepseek-v4-proDeepSeek 上游免费
deepseek-chatDeepSeek 上游免费
deepseek-reasonerDeepSeek 上游免费
qwen-turbo / qwen3.5-flash阿里百炼免费
qwen-plus / qwen3.6-plus阿里百炼免费
qwen-max / qwen3.7-max阿里百炼免费
qwq-plus / qvq-max阿里百炼免费
gpt-5.4 / gpt-5.5ChatGPT-Plus付费
gpt-5.4-miniChatGPT-Plus付费
gpt-5.3-codexChatGPT-Plus付费
gpt-image-2ChatGPT-Plus付费
gpt-5.2-proChatGPT-Plus付费
gpt-4o-realtimeChatGPT-Plus付费
提示：免费模型无需充值，注册即用。付费模型按 token 计费，从余额扣除。新用户赠送 $1 体验金。
六 API 错误码
状态码说明处理方式
401API Key 无效或未提供检查 Key 是否正确，是否以 sk- 开头
402余额不足充值后再试（仅付费模型）
403无权访问该模型或分组检查 API Key 绑定的分组是否正确
429请求频率超限降低请求速率或联系管理员提升配额
500服务器内部错误稍后重试，如持续存在请联系客服
503上游服务暂不可用稍后重试，上游可能正在维护

需要帮助？

邮件：admin@aoyuapi.cn