AI API Gateway Platform

Seven-AI 使用手册

本手册帮助用户快速理解 Seven-AI 的使用流程,完成 API Key 获取、客户端接入、用量查看,并提供常见问题的排查方法。

Overview

Seven-AI 能做什么

Seven-AI 是一个 AI API 聚合平台,可以为多个大模型提供统一的API Key给AI工具使用。一个API Key可以使用多个大模型,省心方便。

统一 API Key

用户使用平台生成的 Key 调用模型,一个Key可连接多个模型。

统一账号调度

注册一个平台账号,就可以使用和切换多个大模型,避免多账号混乱。

用量与计费

支持按 Token 和费用记录用量,便于查看消费、限额和订阅状态。

AI画图体验

有AI画图体验的工具,可以体验一下最先进模型的画图质量和神奇之处

Quick Start

普通用户快速开始

你只需要登录平台、创建 API Key,然后把 Base URL 和 Key 填入客户端。

1

打开平台

浏览器访问本项目网址:

https://seven-ai.cloud
2

注册或登录

使用邮箱账号登录。如果无法注册,请联系客服 qq:2722477173

3

创建 API Key

登录之后,点击左侧表单中的“API 密钥”或者“API Keys”,进入API Keys页面,点击右上角的“创建密钥”。创建后立即复制并保存,避免泄露到聊天、仓库或日志中。

4

选择分组

Key 需要绑定到可用分组。通常绑定“VIP使用”分组即可。

5

配置AI客户端

把Base URL,和API Key 两个参数设置到客户端。模型参数按照“可用渠道”表单页面显示的可用模型来设置,比如gpt-5.5。不同客户端的路径示例见下方章节 “客户端接入示例”。

Base URL:https://api.seven-ai.cloud/v1
API Key :自己生成的
6

查看用量

进入“使用记录”“订阅”“余额”页面,检查请求是否成功计费,避免超额或频繁触发限流。

User Guide

用户常用页面说明

页面 用途 建议操作
Dashboard / 仪表盘 查看账户概况、余额和快捷入口。 首次登录后先确认余额、订阅和公告。
API Keys / 密钥 创建、复制、禁用、限制 API Key。 为不同项目创建不同 Key,便于追踪和停用。
Usage / 使用记录 查看调用成本、Token、错误和时间。 排查失败请求时先按 Key 和时间筛选。
Available Channels / 可用渠道 查看当前可用模型或渠道状态。 模型不可用时先确认渠道是否在线。
Payment / Redeem / 订阅 充值、兑换、查看订阅状态。 请求提示余额不足时检查这里。

Client Integration

客户端接入示例

以下示例中的 API 平台地址为:https://api.seven-ai.cloudBASE_URL 针对不同的模型接口,会有相应的适配;

一般常用的客户端都支持OpenAI Chat Completions接口,按照OpenAI Chat Completions接口方式来配置即可。

OpenAI Chat Completions

适用于支持 OpenAI 兼容接口的 SDK、插件或应用。

OPENAI_BASE_URL=https://api.seven-ai.cloud/v1
OPENAI_API_KEY=sk-xxx

Claude / Anthropic Messages

适用于 Claude Code 或 Anthropic Messages API 兼容客户端。

export ANTHROPIC_BASE_URL="https://api.seven-ai.cloud"
export ANTHROPIC_AUTH_TOKEN="sk-xxx"

OpenAI Responses / Codex

适用于 Responses API 或 Codex 相关兼容入口。

OPENAI_BASE_URL=https://api.seven-ai.cloud/v1
OPENAI_API_KEY=sk-xxx

Gemini v1beta

适用于 Gemini 原生 API 兼容客户端。

GEMINI_BASE_URL=https://api.seven-ai.cloud/v1beta
GEMINI_API_KEY=sk-xxx

Base URL 怎么填

如果客户端要求“Base URL 不包含版本号”,填写 https://api.seven-ai.cloud。如果客户端要求 OpenAI 兼容地址,通常填写 https://api.seven-ai.cloud/v1。不确定时优先查看客户端文档。

Image Generation

AI画图体验

登录后,打开左侧表单中“AI画图体验”页面,点击右上角“新窗口打开”。在新页面中,点击右上角“设置”按钮,在 设置-API设置 页面把“API URL”和“API Key”按照前述的Base URL、API Key内容填写上。就可以体验目前最先进的画图模型了,画出自己想要的图片。

快速体验,请点击:AI画图。需要填写API URL和API Key后使用。

Troubleshooting

常见问题与解决方法

无法打开网页或访问超时

确认访问的网址是否正确: https://seven-ai.cloud。如果正确,请联系客服 qq:2722477173

登录失败或注册失败

确认访问的网址是否正确: https://seven-ai.cloud。如果确认正确,请联系客服 qq:2722477173 处理

API Key 无效,返回 401

确认客户端请求头为 Authorization: Bearer sk-xxx,不要漏掉 Bearer。同时检查 Key 是否被禁用、是否复制完整、是否使用了错误平台的 Key。

提示 Key 未绑定分组或无可用分组

进入“API Keys/密钥”页面为 Key 选择分组。如果无可用分组,请联系客服qq:2722477173

余额不足、订阅不可用或请求被拒绝

检查用户余额、订阅状态、Key 配额、分组倍率和限额设置。如果启用了计费,余额不足会导致请求失败。

返回 429 或提示限流

降低并发和请求频率,稍后重试。如果持续出现限流,请检查 API Key 配额或联系客服 qq:2722477173。

返回 502、503 或上游错误

通常是服务繁忙、模型暂不可用或网络波动导致。请稍后重试,并确认选择的模型可用。如果持续失败,请联系客服 qq:2722477173。

模型列表为空或模型不可用

确认 Key 所在分组的平台类型是否匹配客户端。OpenAI、Claude、Gemini 和 Antigravity 的模型接口不同,Base URL 和请求路径不能混用。

Antigravity 的 Claude Code Plan Mode 无法自动退出

这是已知限制。可按 Shift + Tab 手动退出 Plan Mode,然后输入你的确认或拒绝回复。

Security

安全使用建议

保护 API Key

不要把 Key 写入公开仓库、截图、日志或共享文档。发现泄露后立即禁用并重新创建。

不要共享 API Key

一个 API Key 代表你的账号调用权限,不要借给他人使用,避免产生无法确认来源的消费。

查看使用记录

定期查看“使用记录”页面,发现异常请求、异常模型或异常消费时及时处理。

异常及时联系

如果无法判断问题原因,保留错误截图、请求时间和使用的模型名称,联系客服 qq:2722477173。