
7API 的功能
7API 是一个 API 网关,通过一个 API 密钥、一个余额和按 Token 计费的模式,提供对多个 AI 模型系列的访问。它支持兼容 OpenAI 和 Anthropic 的接口,因此现有应用只需更改 API 密钥、基础 URL 和模型 ID,即可切换供应商。
可用的模型系列包括 Claude、GPT、Gemini、Grok、DeepSeek、GLM 和 Kimi。除标准模型外,在可用时还会提供部分无审查和消融变体。7API 是网关,而非这些模型的所有者,因此模型行为、条款、标识符、价格和可用性可能因底层供应商而异。
重要提示:无审查模型的设计目标是比标准模型拒绝更少的请求,但这并不保证它永远不会拒绝。应用仍需要进行评估、设置适当的防护措施、接受人工审核,并遵守供应商条款及适用法律。
主要功能
- 一个 API 密钥:使用一个账户访问七个主要模型系列中的受支持模型。
- 兼容 OpenAI:连接支持自定义 OpenAI
base_url的客户端。 - 兼容 Anthropic:使用 Anthropic 风格的端点、Anthropic SDK 以及 Claude Code 等兼容工具。
- 无审查选项:在实时目录中提供时,选择无审查和消融变体。
- 按 Token 计费:无需订阅、月度最低消费或席位费用。
- 提示词缓存:重复的前缀可以按更低的缓存输入费率计费。
- 子密钥:为团队成员、客户或项目分开管理资金和用量。
- 兼容工具:使用 Cursor、Codex CLI、OpenCode、LangChain、LlamaIndex,以及其他接受兼容 OpenAI 或 Anthropic 供应商的客户端。
开始之前
通过7API 网站创建账户。控制面板会提供以 sk- 开头的 API 密钥、正确的基础 URL、当前模型 ID、上下文限制、实时可用性和价格。
在生产环境中使用旧示例里的基础 URL 或模型 ID 之前,请先检查控制面板,不要直接复制。供应商可能会发布新版本,模型标识符或无审查变体也可能轮换。
安装 SDK
对于 Python,请安装与计划使用的接口相匹配的 SDK。OpenAI 兼容示例只需要 OpenAI 包,Anthropic 兼容示例只需要 Anthropic 包。
pip install openai
pip install anthropic配置环境变量
将凭据存储在源代码之外。从控制面板复制准确的基础 URL,并与密钥一起导出:
export SEVEN_API_KEY="sk-..."
export SEVEN_API_BASE_URL="https://.../v1"避免将真实 API 密钥提交到代码仓库。使用服务器端环境变量或密钥管理器,优于将凭据硬编码。
发起兼容 OpenAI 的请求
当应用已经使用 OpenAI SDK 或其他允许自定义基础 URL 的客户端时,兼容 OpenAI 的接口非常实用。
- 导入
OpenAI,并从环境变量中读取凭据。 - 使用 7API 密钥和基础 URL 初始化客户端。
- 将
MODEL_ID替换为控制面板中的当前标识符。 - 发送聊天补全请求,并读取返回的助手消息。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SEVEN_API_KEY"],
base_url=os.environ["SEVEN_API_BASE_URL"],
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[
{
"role": "system",
"content": "你是一名精准且乐于助人的助手。"
},
{
"role": "user",
"content": "用两段话解释模型路由的权衡。"
},
],
)
print(response.choices[0].message.content)许多兼容 OpenAI 的应用也可以采用这种集成模式。在典型的现有配置中,主要需要更改的是基础 URL、API 密钥和所选模型 ID。
发起兼容 Anthropic 的请求
当应用需要 Anthropic Messages API 时,请使用兼容 Anthropic 的接口。控制面板可能会显示专用的 Anthropic 基础 URL,因此请使用该准确端点,不要假设它与兼容 OpenAI 的 URL 相同。
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["SEVEN_API_KEY"],
base_url=os.environ["SEVEN_API_BASE_URL"],
)
message = client.messages.create(
model="MODEL_ID",
max_tokens=1024,
messages=[
{
"role": "user",
"content": "为开发者工具编写一份简洁的发行说明。"
}
],
)
print(message.content[0].text)将 MODEL_ID 替换为当前可用的模型。在此示例中,响应从 message.content[0].text 读取。
使用 cURL 测试 API
在集成 SDK 之前,可以通过直接发送 HTTP 请求验证密钥、基础 URL、模型 ID 和账户配置。
curl "$SEVEN_API_BASE_URL/chat/completions" \
-H "Authorization: Bearer $SEVEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "来自 7API 快速入门示例的问候。"
}
]
}'如果请求失败,请先确认环境变量已设置、端点与所选兼容模式匹配,并且模型 ID 出现在当前控制台目录中。
选择模型系列
模型选择应根据工作负载,而不应仅依据“无审查”标签。README 为每个系列列出了几个常见应用领域:
- Claude:长篇推理、写作和编码代理。
- GPT:通用助手、工具调用和结构化输出。
- Gemini:多模态工作流、研究和长上下文任务。
- Grok:实时风格的回答和创意构思。
- DeepSeek:编码、推理和高性价比代理。
- GLM:代理、编码和双语工作。
- Kimi:长文档阅读和代理工作流。
这些系列中的模型并非全部都是无审查模型。请查看实时目录,以区分标准模型与精选的无审查或已移除限制的变体。请测试计划部署的确切版本,因为不同版本之间的行为可能发生变化。
连接现有开发者工具
7API 可用于接受自定义兼容提供商的工具。所需配置取决于客户端所要求的接口:
- Claude Code:将其 Anthropic 基础 URL 配置指向兼容 Anthropic 的 7API 端点。
- Cursor:将 7API 添加为自定义的 OpenAI 兼容提供商。
- Codex CLI:配置 OpenAI 兼容的提供商配置文件。
- OpenCode:添加自定义提供商和有效的模型 ID。
- LangChain 或 LlamaIndex:使用 OpenAI 兼容适配器,并配置 7API 基础 URL 和密钥。
- 其他兼容应用:替换提供商基础 URL 和 API 密钥,然后选择受支持的模型 ID。
如果工具使用不同的环境变量名称或配置文件,请参阅代码库中针对该客户端的文档。
高级使用技巧
使用相同提示词比较模型
由于多个模型系列可通过同一网关使用,你可以向多个模型 ID 发送一致的评估提示词,而无需重建整个集成。请在选择生产模型前比较输出质量、拒答行为、成本、延迟和可靠性。
为模型变更做好准备
不要假设模型 ID 或行为会永久保持不变。随着提供商更新目录,可用模型可能会轮换。将模型选择设为可配置,在控制台中确认当前 ID,并在上游版本变更后重新评估重要提示词。
在适当场景使用提示词缓存
反复发送相同提示词前缀的应用可能受益于更低的缓存输入费率。请在估算节省金额前查看实时定价信息,因为提供商费率可能发生变化。
使用子密钥分离项目
当团队成员、客户或项目需要与主余额分开计费时,请使用子密钥。这样既便于集中访问,也能使使用边界更加清晰。
按工作负载进行路由
单一网关使你可以根据不同任务选择不同的模型系列。例如,应用可以为长文档评估一个系列,为编码或结构化输出评估另一个系列。路由决策应基于当前模型版本的实测结果。
添加应用级安全措施
降低拒答行为并不意味着可以省略控制措施。请验证模型输出、限制敏感工具的访问、记录适当的运营数据、对重要工作流实施人工审核,并遵守底层提供商的条款。
定价和账户注意事项
7API 采用按令牌付费的计费方式,而非订阅制。用户可以为共享余额充值,并在受支持的模型之间使用余额。支持的充值选项包括 BTC、ETH、USDT 和 LTC。提供商更新费率时,实时价格可能发生变化,因此预算规划应以控制台信息为准,而不要依赖静态估算。
该服务还列出了推荐计划:推荐人可获得被推荐者充值金额的 15%。这与 API 运行分开,使用该网关并不要求参与推荐计划。
常见限制
- 没有任何提供商能够保证无审查或已移除限制的模型永远不会拒绝请求。
- 模型、版本、提示词和提供商政策都会影响行为。
- 模型 ID、价格和可用性可能发生变化。
- 通过网关使用时,仍需遵守提供商条款。
- 开发者仍需对合法且合乎道德的使用、评估、安全防护和人工监督负责。
结论
7API 提供了一种统一方式,让你通过兼容 OpenAI 和 Anthropic 的接口评估并调用 Claude、GPT、Gemini、Grok、DeepSeek、GLM 和 Kimi 模型。首先获取控制台凭据,使用 cURL 测试当前模型 ID,然后集成适合的 SDK 或开发者工具。在投入生产前,请比较确切的模型版本,监控价格和可用性,并根据应用需求采取相应的安全措施。
