📖 帮助手册

📂 开源地址：github.com/xianyangeng/aeon-token-proxy
💬 问题反馈请提交 GitHub Issue

📑 目录

1. 快速开始 2. 可用模型 3. 多模态接入 4. SDK & 客户端 5. OpenClaw 接入 6. Hermes Agent 接入 7. 计费说明 8. 推荐奖励 9. 常见问题

🚀 快速开始

1. 注册账号 → 在仪表盘获取 API Key

2. 充值或订阅套餐 → 获得调用额度

3. 接入代码（OpenAI 兼容接口）：

pip install openai

from openai import OpenAI
client = OpenAI(
    api_key="opc-xxx",
    base_url="https://moreapi.uk/v1"
)
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

📋 可用模型

模型Provider多模态输入 ¥/1K输出 ¥/1K
claude-haiku-4anthropic✅0.00250.01
claude-sonnet-4anthropic✅0.0150.075
deepseek-chatdeepseek❌0.000140.00028
deepseek-reasonerdeepseek❌0.000140.00028
deepseek-v4-flashdeepseek❌0.000140.00028
gemini-2.5-flashgemini✅0.0010.004
gemini-2.5-progemini✅0.010.04
gpt-4.1openai✅0.010.04
gpt-4oopenai✅0.0150.06
gpt-4o-miniopenai✅0.00150.006
groq-deepseekgroq❌0.00030.0003
groq-llama-4groq❌0.00030.0003
groq-mixtralgroq❌0.00030.0003
o3openai✅0.050.2
o4-miniopenai✅0.0020.008
ollama-deepseek-r1ollama❌00
ollama-llama3ollama❌00
ollama-qwenollama❌00

✅ = 支持多模态（图片/视觉输入）

🖼️ 多模态接入

OPC Proxy 完整支持多模态（图片识别），兼容 OpenAI 格式，一行切换模型即可。

📱 支持的模型

模型供应商图片格式上限
gpt-4oOpenAIbase64 / URL20MB
gpt-4o-miniOpenAIbase64 / URL20MB
o3 / o4-miniOpenAIbase64 / URL20MB
claude-sonnet-4Anthropicbase64 / URL20MB
claude-haiku-4Anthropicbase64 / URL20MB
gemini-2.5-proGeminibase6420MB
gemini-2.5-flashGeminibase6420MB

💻 Python 代码示例

from openai import OpenAI
import base64

client = OpenAI(
    api_key="opc-xxx",
    base_url="https://moreapi.uk/v1"
)

# 读取图片为 base64
def encode_image(path):
    with open(path, "rb") as f:
        return base64.b64encode(f.read()).decode()

base64_img = encode_image("photo.jpg")

# 多模态请求（文本 + 图片）
response = client.chat.completions.create(
    model="gpt-4o",              # 切换模型即可
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "这张图片里有什么？"},
            {
                "type": "image_url",
                "image_url": {
                    "url": f"data:image/jpeg;base64,{base64_img}"
                }
            }
        ]
    }]
)
print(response.choices[0].message.content)

🌐 cURL 示例

curl https://moreapi.uk/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer opc-xxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "描述这张图片"},
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/photo.jpg"
          }
        }
      ]
    }]
  }'

🖥️ Web 对话框使用

在 AI 对话页面 中支持：

  • 📎 点击图片按钮选择文件上传
  • 📋 直接粘贴截图（Ctrl+V / ⌘+V）
  • 🖱️ 拖拽图片到聊天区域
  • 🔄 自动转换为多模态格式发送
  • 📷 支持 JPEG / PNG / WebP / GIF 格式
💡 提示：多模态请求会自动路由到对应的上游 API （OpenAI、Anthropic、Gemini），你无需关心底层格式差异。 系统会自动处理 image_url → base64 转换。

🔌 SDK & 客户端

Python SDK — sdks/python/

from opc_proxy import OPCClient
client = OPCClient(api_key="opc-xxx", base_url="https://moreapi.uk")
response = client.chat("Hello")
print(response)

Node.js SDK — sdks/node/

npm install @opc-proxy/client

const OPC = require('@opc-proxy/client');
const client = new OPC({ apiKey: 'opc-xxx', baseUrl: 'https://moreapi.uk' });
client.chat('Hello').then(console.log);

VS Code 插件 — extensions/vscode/

  • 侧边栏 AI 对话（多模型切换）
  • 选中代码解释 / 重构
  • 添加上下文文件
  • AI 快速修复诊断问题

快捷键：Ctrl+Alt+O 打开对话 / Ctrl+Alt+E 解释代码

Chrome 扩展 — extensions/chrome/

  • 浏览器中随时调用 AI
  • 选中文本右键 → AI 解释

🦞 OpenClaw — AI 网关/Agent 平台

  • 将 Aeon 设为模型提供者，统一管理和计费
  • 支持 OpenAI 兼容接口，一行配置即可
  • 一键接入脚本：./setup-aeon.sh <API_KEY> <服务器地址>
# openclaw.json 配置
{
  "agents": {
    "defaults": {
      "model": {
        "openaiBaseUrl": "https://moreapi.uk/v1",
        "openaiApiKey": "opc-xxx"
      }
    }
  }
}

🤖 Hermes Agent — 智能 AI Agent 框架

  • 支持任意 OpenAI 兼容 API 作为后端
  • 配置环境变量即可接入 Aeon
  • 一键接入脚本：./setup-aeon.sh <API_KEY> <服务器地址>
# ~/.hermes/.env 配置
AI_GATEWAY_BASE_URL=https://moreapi.uk/v1
AI_GATEWAY_API_KEY=opc-xxx

🦞 OpenClaw 接入

OpenClaw 是一款 AI 网关/Agent 平台，支持 OpenAI 兼容接口。
将 Aeon 设为 OpenClaw 的模型提供者，即可享受统一计费和模型聚合。

📦 一键接入（推荐）

# 下载脚本并运行
curl -O https://moreapi.uk/sdks/setup-aeon.sh
chmod +x setup-aeon.sh
./setup-aeon.sh <你的API_KEY> https://moreapi.uk

🔧 手动配置

在 openclaw.json 中配置：

{
  "agents": {
    "defaults": {
      "model": {
        "openaiBaseUrl": "https://moreapi.uk/v1",
        "openaiApiKey": "opc-xxx"
      }
    }
  }
}

或通过命令行设置：

openclaw config set agents.defaults.model.openaiBaseUrl "https://moreapi.uk/v1"
openclaw config set agents.defaults.model.openaiApiKey "opc-xxx"
openclaw gateway restart
💡 配置后，OpenClaw Agent 即可使用 Aeon 的所有模型： deepseek-chat、deepseek-v4-flash、gpt-4o、claude-sonnet-4 等

🤖 Hermes Agent 接入

Hermes Agent 是一款智能 AI Agent 框架。
支持任意 OpenAI 兼容 API 作为后端，可配置使用 Aeon 代理。

📦 一键接入（推荐）

# 下载脚本并运行
curl -O https://moreapi.uk/sdks/setup-aeon.sh
chmod +x setup-aeon.sh
./setup-aeon.sh <你的API_KEY> https://moreapi.uk

🔧 手动配置

在 ~/.hermes/.env 或项目根目录 .env 中添加：

# Aeon Proxy (替换你自己申请的 API Key)
AI_GATEWAY_BASE_URL=https://moreapi.uk/v1
AI_GATEWAY_API_KEY=opc-xxx

或通过环境变量覆盖：

export AI_GATEWAY_BASE_URL=https://moreapi.uk/v1
export AI_GATEWAY_API_KEY=opc-xxx
hermes start
📖 详细说明：Hermes Agent 会自动识别 AI_GATEWAY_BASE_URL 环境变量， 所有 API 请求通过 Aeon 代理转发至后端模型。

💰 计费说明

按量付费：预充值，按 Token 扣费，单价见上方表格。

订阅套餐：月付/年付，含固定额度，超量按 ¥0.3-0.5/百万Token 计费。

充值：点击充值，支持支付宝（测试模式直接到账）。

💎 省钱建议：高频使用 DeepSeek / Gemini Flash 性价比最高； GPT-4o / Claude 适合复杂任务。推荐订阅套餐可大幅降低成本。

🎯 推荐奖励

每推荐一位好友注册并充值，你和好友各获得 ¥10 奖励！

好友使用你的推荐码注册，首单套餐享 9折优惠

推荐码可在仪表盘查看

❓ 常见问题

Q: API Key 在哪里获取？
注册登录后，在仪表盘页面即可看到你的 API Key。
Q: 支持哪些编程语言？
任何支持 OpenAI SDK 的语言均可使用：Python、Node.js、Java、Go、Ruby 等。
Q: 多模态图片上传多大？
单张图片不超过 20MB，支持 JPEG、PNG、WebP、GIF 格式。
Q: 如何切换模型？
修改请求中的 model 字段即可，无需改其他代码。
Q: 数据安全如何？
所有请求通过香港服务器转发，不存储你的对话内容。支持私有化部署。
Q: 如何私有部署？
克隆 GitHub 仓库，配置 .env 即可一键部署：
git clone https://github.com/xianyangeng/aeon-token-proxy.git && cd opc-api-proxy && python main.py

💬 联系 & 贡献

📂 GitHub：github.com/xianyangeng/aeon-token-proxy

⭐ 觉得好用？给我们一个 Star！

🐛 提交 Issue：github.com/xianyangeng/aeon-token-proxy/issues

📧 邮箱：[email protected]