交給 AI 接入

按模型族選擇 Essevin 接入契約,讓編程 AI 只配置當前需要的模型與密鑰。

先選擇要使用的模型族,再把當前標籤中的契約交給 Codex、Claude Code、Cursor 或其他編程 AI。每份契約只包含這一類模型所需的密鑰、協議和端點,不會讓 AI 同時配置全部能力。

先選擇正確的模型標籤

你要接入的能力選擇標籤使用的套餐密鑰
Claude API 或 Claude CodeClaudeClaude 分組密鑰
GPT 對話、Codex Responses 或 GPT ImageGPT / CodexOpenAI / Codex 分組密鑰
Gemini 對話或 Banana 圖片GeminiGemini 分組密鑰

一類模型對應一把套餐密鑰

多模型項目使用當前契約列出的獨立環境變量,例如 ESSEVIN_CLAUDE_API_KEYESSEVIN_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 透傳和脫敏日誌

契約不會把普通的單用戶本地接入改造成複雜網關;只有項目代表下游客戶發起請求時,才要求補齊服務端保護措施。

本頁目錄