接入方式

把 Zaokit 接到常见客户端、IDE 代理与图片生成链路。页面结构参考 OpenAI API Reference，便于开发者快速定位端点、配置与示例。

OpenAI Responses Anthropic Messages Codex Claude Code Image Generation

端点一览

按软件填写项选择「完整地址」或 base_url。

场景	地址
OpenAI Responses API（完整地址）	`https://api.zaokit.com/v1/responses`
Anthropic Messages API（完整地址）	`https://api.zaokit.com/v1/messages`
OpenAI base_url	`https://api.zaokit.com/v1`
Anthropic base_url	`https://api.zaokit.com`
Codex / Claude Code / 图片	`https://api.zaokit.com/v1` 或 `https://api.zaokit.com`

鉴权说明

API_KEY= "sk-zaokit-xxxx你的API_KEY"

请求时把真实 Key 填入 Authorization: Bearer ...，或客户端对应的 API Key 字段。

1.1 API 使用方式

兼容两种常见协议格式：

// OPENAI ResponseAPI格式
openai_url = "https://api.zaokit.com/v1/responses"

// Anthropic API格式
anthropic_url = "https://api.zaokit.com/v1/messages"

base_url 填写规则

如果软件填写项叫 base_url，通常应填写：

OpenAI：https://api.zaokit.com/v1
Anthropic：https://api.zaokit.com

软件会自动补上后面的 /responses 或 /v1/messages。只有填写项明确要求“完整请求地址”时，才使用上面两个完整链接。

1.2 Codex 使用方式

下载地址：https://openai.com/zh-Hans-CN/codex/

修改 ~/.codex/config.toml 文件，添加以下内容到开头即可，其他内容保持不变。

model = "gpt-5-6-sol"
model_reasoning_effort = "high"
personality = "pragmatic"

model_provider = "zaokit"
[model_providers.zaokit]
name = "zaokit"
base_url = "https://api.zaokit.com/v1"
wire_api = "responses"
experimental_bearer_token = "sk-zaokit-你的API_KEY"
requires_openai_auth = true

1.3 Claude Code 使用方式

安装

平台	命令
macOS / Linux / WSL	`curl -fsSL https://claude.ai/install.sh \| bash`
Windows (PowerShell)	`irm https://claude.ai/install.ps1 \| iex`
Windows (CMD)	`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`
Alternative macOS (Homebrew)	`brew install --cask claude-code`

启动配置

下面示例使用 grok-4.5，可按需要改成 GPT / Claude 等模型。

alias ccgrok='env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy -u ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL="https://api.zaokit.com" ANTHROPIC_API_KEY="sk-zaokit-xxxxx你的API_KEY" CLAUDEX_DEFAULT_MODEL="grok-4.5" ANTHROPIC_MODEL="grok-4.5" ANTHROPIC_SMALL_FAST_MODEL="grok-4.5" ANTHROPIC_DEFAULT_OPUS_MODEL="grok-4.5" ANTHROPIC_DEFAULT_SONNET_MODEL="grok-4.5" ANTHROPIC_DEFAULT_HAIKU_MODEL="grok-4.5" CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 CLAUDE_CODE_SIMPLE=1 claude --bare --setting-sources local --model grok-4.5 --dangerously-skip-permissions'

1.4 图片生成接入方式

1.4.1 Images API

直接走官方兼容图片接口，模型使用 gpt-image-2。

curl -X POST "https://api.zaokit.com/v1/images/generations" \
  -H "Authorization: Bearer <你的key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "蓝色狐狸，白色背景，卡通风格",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

成功时返回 data[0].b64_json。

1.4.2 Responses API

主模型走 gpt-5.5，图片工具走 gpt-image-2。

curl -X POST "https://api.zaokit.com/v1/responses" \
  -H "Authorization: Bearer <你的key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "画一只蓝色狐狸，白色背景，卡通风格"
          }
        ]
      }
    ],
    "tools": [
      {
        "type": "image_generation",
        "action": "generate",
        "model": "gpt-image-2"
      }
    ],
    "tool_choice": "auto",
    "stream": false
  }'

这条会返回 output.type=image_generation_call。把 <你的key> 换成你实际 key 即可直接使用。