交给 AI 接入
按模型族选择 Essevin 接入契约,让编程 AI 只配置当前需要的模型与密钥。
先选择要使用的模型族,再把当前标签中的契约交给 Codex、Claude Code、Cursor 或其他编程 AI。每份契约只包含这一类模型所需的密钥、协议和端点,不会让 AI 同时配置全部能力。
先选择正确的模型标签
| 你要接入的能力 | 选择标签 | 使用的套餐密钥 |
|---|---|---|
| Claude API 或 Claude Code | Claude | Claude 分组密钥 |
| GPT 对话、Codex Responses 或 GPT Image | GPT / Codex | OpenAI / Codex 分组密钥 |
| Gemini 对话或 Banana 图片 | Gemini | Gemini 分组密钥 |
一类模型对应一把套餐密钥
多模型项目使用当前契约列出的独立环境变量,例如 ESSEVIN_CLAUDE_API_KEY 或 ESSEVIN_GEMINI_API_KEY;单模型项目可继续使用 ESSEVIN_API_KEY。不要把真实密钥粘贴到 AI 对话,也不要写进源码、提交记录、截图或日志。
Anthropic Messages / Claude Code,只使用 Claude 分组密钥
请在当前项目中只接入 Essevin 的Claude 模型,并遵守以下契约:
本次范围
- 只完成Claude API 或 Claude Code所需的接入;不要添加、配置或测试未被本契约选中的其他模型族。
- 保留项目现有框架、SDK 和代码风格,只做本次接入所需的最小修改。
- 先识别这是本地单用户、内部服务调用,还是代表下游客户 / 多租户发起请求,再决定密钥放置和调用架构。
密钥与模型
- 本契约只使用Claude 分组密钥。多模型项目优先读取 ESSEVIN_CLAUDE_API_KEY 或现有密钥管理器;只有明确为单模型项目时才可复用 ESSEVIN_API_KEY。
- 不要创建新密钥,不要读取其他模型族的密钥,也不要要求我把真实密钥粘贴进对话。密钥不存在时停止并提示我在本机或密钥管理器中配置。
- 先用这把密钥调用 GET https://api.essevin.com/v1/models,只选择返回列表中以 claude- 开头的模型 ID。
- 如果返回 model_not_found,重新读取 /v1/models 并使用实际返回的完整模型 ID,绝不猜测或改写模型名。
连接参数
- 使用 Anthropic 协议,Base URL 为 https://api.essevin.com,不带 /v1。
- Anthropic SDK 使用 api_key;原生 HTTP 使用 x-api-key。现有 Anthropic 代码优先保持原生鉴权。
- Claude API 请求由 SDK 发往 POST /v1/messages,不要改成 OpenAI Chat Completions。
- Claude Code 使用 ANTHROPIC_BASE_URL=https://api.essevin.com 和 ANTHROPIC_AUTH_TOKEN,令牌值必须来自本契约选定的 Claude 密钥。
实施要求
- 检查现有依赖和配置,优先复用已经安装的 SDK;不要删除或覆盖其他供应商配置。
- 将 Base URL、密钥变量名和默认模型写入项目现有配置体系,并同步更新 .env.example;禁止写入真实密钥。
- 下游 / 多租户调用必须把密钥留在服务端,并复用调用方鉴权,增加模型 allowlist、请求限制、超时、限流、用量归因和脱敏日志。
- 单用户本地工具不要为此引入代理服务或多租户网关。
- 默认模型必须从 /v1/models 返回的 Claude 模型中选择,不要硬编码文档示例。
- 流式调用需端到端透传 Anthropic SSE,并保留上游 4xx / 5xx 状态和可公开错误信息。
验证与交付
- 配置后发送一次最小真实请求;只有项目实际使用流式响应时才追加流式测试。
- 用返回列表中的 Claude 模型发送一条“只回复 ok”的 Messages 请求,并验证响应 content。
- 最后报告修改文件、密钥变量名、模型 ID、端点、HTTP 状态和脱敏响应摘要,并给出启动、验证和回滚命令。切换标签时,代码区和“复制给 AI”会同步切换。契约要求 AI 只使用当前模型族的密钥执行模型发现,再从返回列表中选择模型,避免跨套餐误配。
AI 会如何判断下游场景
| 项目场景 | AI 应采用的接入方式 |
|---|---|
| 本地单用户工具 | 直接使用环境变量和对应 SDK,不额外增加代理服务 |
| 内部服务 | 在服务端保存密钥,并保留现有鉴权、限流和错误处理 |
| 面向客户或多租户 | 增加密钥隔离、调用方鉴权、模型 allowlist、限流、用量归因、SSE 透传和脱敏日志 |
契约不会把普通的单用户本地接入改造成复杂网关;只有项目代表下游客户发起请求时,才要求补齐服务端保护措施。