資源中心

資源分類

新手入門

第一次用？兩條路選一條，別想複雜。

快速開始

Claude Code 接入

Anthropic 官方 CLI。推薦用控制台「一鍵接入」，一條命令自動裝好配好；懂終端機的也可以手動設定環境變數。

手動配置 · macOS / Linux（zsh / bash）

臨時設定（只在當前終端機視窗有效，關窗即失效）：

export ANTHROPIC_BASE_URL=https://api.essevin.com
export ANTHROPIC_AUTH_TOKEN=sk-你的金鑰

# 然後正常啟動
claude

永久寫入配置（推薦，寫進 shell 啟動檔，以後開窗即用）：

# zsh（macOS 預設）
echo 'export ANTHROPIC_BASE_URL=https://api.essevin.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的金鑰' >> ~/.zshrc
source ~/.zshrc

# bash（Linux 常見；與上面 zsh 二選一）
echo 'export ANTHROPIC_BASE_URL=https://api.essevin.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的金鑰' >> ~/.bashrc
source ~/.bashrc

手動配置 · Windows（PowerShell）

臨時設定（只在當前 PowerShell 視窗有效）：

$env:ANTHROPIC_BASE_URL = "https://api.essevin.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的金鑰"

# 然後正常啟動
claude

永久設定（寫入系統環境變數，設定後要關閉並重新開啟終端機才生效）：

setx ANTHROPIC_BASE_URL "https://api.essevin.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的金鑰"

Codex CLI 接入

OpenAI 官方編程代理。同樣推薦一鍵接入；手動方式是改一個配置檔。

手動配置：編輯 config.toml

配置檔位置：macOS / Linux 在 ~/.codex/config.toml；Windows 在 C:\Users\你的使用者名稱\.codex\config.toml（沒有就新建）。內容相同：

# config.toml
model_provider = "essevin"
model = "gpt-5.5"

[model_providers.essevin]
name = "Essevin"
base_url = "https://api.essevin.com/v1"
wire_api = "responses"
requires_openai_auth = true

然後設定金鑰環境變數並啟動。macOS / Linux：

export OPENAI_API_KEY=sk-你的金鑰
codex

Windows（PowerShell）：

$env:OPENAI_API_KEY = "sk-你的金鑰"
codex

# 想永久生效則改用 setx（設定後重開終端機）：
setx OPENAI_API_KEY "sk-你的金鑰"

編輯器 / IDE 接入

Cursor、Trae 和 VS Code 裡的 AI 插件（Cline / Roo Code / Continue 等）都支援自訂模型供應商，本質是填三樣：Base URL、API 金鑰、模型 ID。VS Code 的官方 Claude Code / Codex 插件與 CLI 共用配置，按上面兩節設定好即可。

Cline / Roo Code（VS Code 插件）

插件設定 → API Provider：GPT 模型選「OpenAI Compatible」；Claude 模型選「Anthropic」（Base URL 填不帶 /v1 的地址）。再填 API Key 和 Model ID，保存即用。

Continue（VS Code / JetBrains 插件）

# ~/.continue/config.yaml 的 models 段
models:
  - name: Essevin GPT
    provider: openai
    model: gpt-5.5
    apiBase: https://api.essevin.com/v1
    apiKey: sk-OpenAI套餐金鑰
  - name: Essevin Claude
    provider: anthropic
    model: claude-sonnet-4-6
    apiBase: https://api.essevin.com
    apiKey: sk-Claude套餐金鑰

Cursor

Cursor Settings → Models：API Keys 裡填入 OpenAI 套餐金鑰，開啟「Override OpenAI Base URL」填 https://api.essevin.com/v1，再把要用的 GPT 模型 ID 加進模型列表並勾選。Claude 模型請改填 Anthropic API Key 一欄並覆蓋 Anthropic Base URL（不帶 /v1，需較新版本 Cursor）。注意 Tab 補全等內建功能仍走 Cursor 官方，此配置只對 Chat 裡選中的自訂模型生效。

Trae

設定 → 模型 → 添加模型：GPT 模型服務商選「OpenAI 相容」；Claude 模型選「Anthropic」類型（地址不帶 /v1）。填 Base URL、API 金鑰和模型 ID，即可在對話裡切換使用。

OpenAI SDK 接入

現有 OpenAI 程式碼只需改 base_url 一行。

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.essevin.com/v1",
    api_key="sk-你的金鑰",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.essevin.com/v1",
  apiKey: "sk-你的金鑰",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

Gemini 對話 API

Gemini 全系對話模型走 OpenAI Chat Completions 相容協議：POST https://api.essevin.com/v1/chat/completions，Authorization: Bearer sk-你的金鑰。現有 OpenAI SDK / 第三方客戶端只需把模型 ID 換成 Gemini，代碼不用改。

curl 示例

curl https://api.essevin.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

串流輸出（SSE，加 "stream": true）

curl https://api.essevin.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.1-pro-preview", "stream": true,
    "messages": [{"role": "user", "content": "你好"}]}'

Gemini 原生格式透傳

從 Gemini SDK 遷移的存量請求體不用改：同一端點也接受 Gemini 原生 contents 欄位，服務端自動識別並按原生格式轉發。

curl https://api.essevin.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "contents": [{"role": "user", "parts": [{"text": "你好"}]}]
  }'

圖片生成 / 編輯 API

Essevin 對客戶端統一提供 OpenAI Images 相容協議。文生圖發到 POST https://api.essevin.com/v1/images/generations；即使模型是 Gemini Banana，也不要傳 Gemini native generateContent payload，Essevin 會根據所選模型自動完成協議適配。

文生圖 · 最短可用 curl

curl https://api.essevin.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一隻柴犬坐在櫻花樹下，日系水彩風格",
    "size": "2048x2048",
    "quality": "medium",
    "background": "opaque",
    "output_format": "png",
    "n": 1
  }'

文生圖 · OpenAI Python SDK

import base64
from openai import OpenAI

client = OpenAI(
    base_url="https://api.essevin.com/v1",
    api_key="sk-你的金鑰",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="一隻柴犬坐在櫻花樹下，日系水彩風格",
    size="2048x2048",
    quality="medium",
    background="opaque",
    output_format="png",
    n=1,
)

image = resp.data[0]
with open("result.png", "wb") as f:
    f.write(base64.b64decode(image.b64_json))

通用圖生圖 / 圖片編輯 · multipart curl

curl https://api.essevin.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的金鑰" \
  -F "model=gpt-image-2" \
  -F "prompt=把參考圖改成梵高星空風格的油畫" \
  -F "[email protected]" \
  -F "size=1536x1024" \
  -F "quality=medium" \
  -F "output_format=png"

同步回應（預設）

不傳 Prefer 時會等待圖片完成，返回標準 OpenAI Images JSON。圖片通常位於 data[].b64_json，部分模型可能返回 data[].url；usage 提供 token 用量。

{
  "created": 1780000000,
  "data": [{
    "b64_json": "iVBORw0KGgoAAA...",
    "revised_prompt": "..."
  }],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 1056,
    "total_tokens": 1074
  }
}

非同步任務模式（OpenAI Images 網關）

加入 HTTP header Prefer: respond-async 後，支援非同步任務的模型會立即返回 202 Accepted、task_id 與 status_url，再由客戶端輪詢。任務狀態為 pending / processing / completed / failed。完成後 result_content 會包含已儲存圖片的 Markdown URL。部分 Gemini 模型目前仍同步返回，請以實際 HTTP 狀態碼判斷。

# 1. 提交後立即返回 202 + task_id
curl -i https://api.essevin.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -H "Prefer: respond-async" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "電影感的未來城市夜景",
    "size": "2048x2048"
  }'

# 2. 用上一步的 task_id 輪詢
curl "https://api.essevin.com/v1/images/tasks?task_id=你的task_id" \
  -H "Authorization: Bearer sk-你的金鑰"

Anthropic SDK 接入

調用 Claude 模型，改 base_url 即可。

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.essevin.com",
    api_key="sk-你的金鑰",
)

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

通用調用 / curl

OpenAI 協議（GPT 模型）

curl https://api.essevin.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Anthropic 協議（Claude 模型）

curl https://api.essevin.com/v1/messages \
  -H "x-api-key: sk-你的金鑰" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

串流輸出（加 "stream": true）

curl https://api.essevin.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.5", "stream": true,
    "messages": [{"role": "user", "content": "你好"}]}'

第三方客戶端

Cherry Studio、NextChat、LobeChat 等桌面版或網頁版客戶端，按模型在設定裡填入：

報錯速查

遇到報錯先在這裡對號入座，絕大多數問題 1 分鐘能自己解決：