Aegisy AI API Gateway - 使用指南

1 访问 https://aegisy.cc

2 点击右上角「注册」按钮

3 填写邮箱、用户名和密码

4 提交注册，登录账号

步骤 1：进入仪表盘

登录后自动跳转到用户仪表盘（Dashboard）

步骤 2：创建 API Key

在左侧菜单中找到「API Keys」或「令牌管理」

点击「创建新密钥」或「New API Key」按钮

步骤 3：配置密钥

• 名称：给密钥起一个易识别的名称（如 "开发测试"）
• 权限：选择所需的权限范围
• 分组：选择要关联的分组（可选）

步骤 4：保存密钥

创建后会显示完整的 API Key（格式：sk-xxxxxx）

查看当前分组

在仪表盘左侧菜单中找到「分组」或「Groups」

可以看到您所属的所有分组及其配额使用情况

切换默认分组

在分组列表中，点击要切换的分组

点击「设为默认」按钮

新创建的 API Key 将默认关联到此分组

修改现有 Key 的分组

进入「API Keys」页面

点击要修改的 Key 右侧的「编辑」

在下拉菜单中选择新的分组

保存更改

1 访问 Python 官网

2 下载最新版 Python（如 Python 3.12）

3 运行安装包，务必勾选「Add Python to PATH」

4 验证安装：打开 CMD 或 PowerShell 运行

python --version
pip --version

1 访问 Node.js 官网

2 下载 LTS 版本（长期支持版）

3 运行安装包，按默认选项安装

4 验证安装：

node --version
npm --version

Windows 10/11 自带 curl，在 PowerShell 中可直接使用

如果没有，可以通过以下方式安装：

• 使用 Git Bash（安装 Git for Windows）
• 使用 WSL（Windows Subsystem for Linux）

打开终端（Terminal），运行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证安装：

brew --version

macOS 自带 Python 2，需安装 Python 3：

brew install python3

验证安装：

python3 --version
pip3 --version

使用 Homebrew 安装：

brew install node

验证安装：

node --version
npm --version

sudo apt update
sudo apt upgrade -y

sudo apt install python3 python3-pip -y

验证安装：

python3 --version
pip3 --version

方法 1：使用 apt（可能版本较旧）

sudo apt install nodejs npm -y

方法 2：使用 NodeSource（推荐，获取最新版）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs -y

验证安装：

node --version
npm --version

sudo apt install curl -y

验证安装：

curl --version

curl https://aegisy.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "user",
        "content": "你好，介绍一下自己"
      }
    ]
  }'

curl https://aegisy.cc/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，介绍一下自己"
      }
    ]
  }'

pip install openai

from openai import OpenAI

# 初始化客户端
client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://aegisy.cc/v1"
)

# 调用 GPT-4
response = client.chat.completions.create(
    model="gpt-4",
    messages=[
        {"role": "user", "content": "你好，介绍一下自己"}
    ]
)

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

stream = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "讲个笑话"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

npm install openai

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://aegisy.cc/v1'
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'gpt-4',
    messages: [
      { role: 'user', content: '你好，介绍一下自己' }
    ]
  });
  
  console.log(response.choices[0].message.content);
}

main();

• base_url：改为 https://aegisy.cc/v1
• api_key：使用您的 Aegisy API Key

Python：

pip install anthropic

Node.js：

npm install @anthropic-ai/sdk

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://aegisy.cc"
)

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "你好，介绍一下自己"}
    ]
)

print(message.content[0].text)

• gpt-4 - GPT-4 最新版本
• gpt-4-turbo - GPT-4 Turbo 版本
• gpt-3.5-turbo - GPT-3.5 Turbo
• gpt-4o - GPT-4 Omni 多模态模型

• claude-3-5-sonnet-20241022 - Claude 3.5 Sonnet 最新版
• claude-3-opus-20240229 - Claude 3 Opus
• claude-3-sonnet-20240229 - Claude 3 Sonnet
• claude-3-haiku-20240307 - Claude 3 Haiku

• 不要将 API Key 硬编码到代码中
• 使用环境变量存储密钥
• 不要提交含有密钥的代码到公开仓库
• 定期轮换 API Key
• 发现泄露立即删除并重新创建

• 每个分组有独立的配额限制
• 在仪表盘可实时查看用量
• 接近配额时会收到提醒
• 超出配额后请求会被拒绝

• 使用流式输出提升用户体验
• 合理设置 max_tokens 参数
• 避免频繁的小请求，考虑批量处理
• 使用缓存机制避免重复请求

• 始终处理 API 调用的异常
• 实现重试机制（建议指数退避）
• 检查返回的状态码和错误信息
• 记录错误日志便于排查

A: API Key 只显示一次，无法找回。请删除旧的 Key 并创建新的。

A: 检查以下几点：

• API Key 是否正确（注意不要有多余空格）
• Header 格式是否正确（OpenAI 用 Authorization: Bearer，Claude 用 x-api-key）
• API Key 是否已过期或被删除

A: 可能原因：

• 超出了配额限制
• 请求频率过高，触发限流
• 建议：检查配额使用情况，实现请求限流

A: 在请求中修改 model 参数即可，无需更换 API Key。

A: 支持！在请求中设置 stream: true 即可启用流式输出。

A: 可以。建议：

• 使用独立的生产环境 API Key
• 配置足够的配额
• 实现完善的错误处理和重试机制
• 监控 API 使用情况