接入方式

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

# 把引号内占位文字整体替换为平台复制的完整 Key，不要添加任何前缀
ZAOKIT_API_KEY="PASTE_COMPLETE_KEY_HERE"

请求时使用完整 Key，例如放入 Authorization: Bearer ...，或客户端对应的 API Key 字段。

兼容 OpenAI 的 Responses API、传统 Chat Completions API，以及 Anthropic Messages API：

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

// OPENAI 传统 Chat Completions API 格式
openai_chat_url = "https://api.zaokit.com/v1/chat/completions"

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

接口字段和请求格式可参考官方文档：OpenAI Chat Completions API 文档，Anthropic Messages API 文档。

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

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

model = "gpt-6-astra"
model_reasoning_effort = "high"
personality = "pragmatic"

model_provider = "zaokit"
[model_providers.zaokit]
name = "zaokit"
base_url = "https://api.zaokit.com/v1"
wire_api = "responses"
# 把引号内占位文字整体替换为平台复制的完整 Key，不要添加任何前缀
experimental_bearer_token = "PASTE_COMPLETE_KEY_HERE"
requires_openai_auth = true

1.2.1 更新 Codex 模型选择器

#

仅配置 model_provider 时，Zaokit 模型不一定会自动出现在 Codex 的模型选择器中。请下载 Zaokit 模型目录，并让 Codex 在启动时读取这个文件。

AI Native：直接让 Codex 帮你更新

在 Codex App 中新建一个任务，把下面这段话发给 Codex：

发给 Codex 复制

更新我的 Codex App 模型选择器，支持最新的 Zaokit 模型显示。

请参考：https://platform.zaokit.com/docs/api-reference/#codex-model-catalog
模型目录：https://platform.zaokit.com/static/zaokit_model_catalog.json

请识别我的操作系统和 Codex 实际配置位置，先备份现有配置，再下载模型目录并验证文件有效；将 model_catalog_json 设置为该文件的本地绝对路径，放在 config.toml 顶层。若已有这一项，请更新而不要重复添加。保留其他配置和 API Key，不要输出或上传密钥。

使用当前 Codex App 对应的程序检查目录是否加载成功。完成后告诉我如何完全退出并重新打开 Codex App，确认模型选择器显示更新后的模型；不要直接关闭正在进行的任务。

Codex 完成后，按提示完全退出并重新打开 App，再查看模型选择器。可选模型以当时下载的目录和账号权限为准。

手动更新

也可以按下面的步骤自行操作。

下载最新模型目录

第一步：保存模型目录

macOS / Linux：

bash 复制

mkdir -p ~/.codex
curl -fsSL "https://platform.zaokit.com/static/zaokit_model_catalog.json" \
  -o ~/.codex/zaokit_model_catalog.json

Windows PowerShell：

powershell 复制

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Invoke-WebRequest `
  "https://platform.zaokit.com/static/zaokit_model_catalog.json" `
  -OutFile "$HOME\.codex\zaokit_model_catalog.json"

第二步：配置目录路径

在 config.toml 开头添加一行。路径必须指向刚下载的文件，请把用户名替换为自己的用户名。

系统	配置示例
macOS	model_catalog_json = "/Users/你的用户名/.codex/zaokit_model_catalog.json"
Linux	model_catalog_json = "/home/你的用户名/.codex/zaokit_model_catalog.json"
Windows	model_catalog_json = "C:\\Users\\你的用户名\\.codex\\zaokit_model_catalog.json"

不要指向 models_cache.json

models_cache.json 会被 Codex 自动刷新。请使用单独的 zaokit_model_catalog.json，避免模型列表在刷新后被覆盖。

第三步：验证并重启

保存配置后，先检查目录是否已加载。

macOS / Linux：

bash 复制

codex debug models | jq -r '.models[].slug' | grep '^gpt-6-astra$'

Windows PowerShell：

powershell 复制

(codex debug models | ConvertFrom-Json).models.slug |
  Select-String '^gpt-6-astra$'

看到 gpt-6-astra 后，请完全退出 Codex Desktop，再重新打开。只关闭窗口可能不会刷新模型选择器。

以后如何更新

Zaokit 增加或调整模型后，重新运行第一步的下载命令，覆盖本地 zaokit_model_catalog.json，然后完全退出并重新打开 Codex Desktop。模型数量会随服务更新变化，不需要固定为某个数字。

如何恢复

如需停止使用 Zaokit 模型目录，删除 config.toml 中的 model_catalog_json 行，然后重启 Codex Desktop。模型目录文件不包含 API Key，请不要把 API Key 写入该文件。

安装

启动配置

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

# 先把 PASTE_COMPLETE_KEY_HERE 整段替换为平台复制的完整 Key，不要添加任何前缀
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="PASTE_COMPLETE_KEY_HERE" 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'

先把 PASTE_COMPLETE_KEY_HERE 整段替换为从 API Keys 页面复制的完整密钥，再保存 alias。

GPT Image 2.5 的模型 ID 为 gpt-image-2.5-sunburst，不要简写成 gpt-image-2.5。以下示例使用 Zaokit 地址和你自己的完整 API Key。

模型可用性以 Zaokit 为你的 Key 开放的模型和实际请求结果为准；若提示模型不可用，请联系管理员确认开通情况。

# 把引号内占位文字整体替换为平台复制的完整 Key，不要添加任何前缀
export ZAOKIT_API_KEY="PASTE_COMPLETE_KEY_HERE"

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

# 把引号内占位文字整体替换为平台复制的完整 Key，不要添加任何前缀
export ZAOKIT_API_KEY="PASTE_COMPLETE_KEY_HERE"

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

语言模型按兼容接口调用，视频使用统一任务接口。GLM、Kimi 的文件和搜索接口保留各自的参数与返回格式。新增型号需同步模型目录，并确认账号权限和计费。

上表是供应商的完整能力分类，不是 Zaokit 的逐项验收清单。已验证：三家代表性对话、百炼万相视频、GLM / Kimi 搜索与文件解析。实时语音、阿里云独立签名接口、托管智能体及其管理接口尚未完成接入验收。Kimi 的视频理解不等于视频生成。

地址与调用规则

模型对话使用 https://api.zaokit.com/v1/chat/completions；视频使用下面的统一视频接口。GLM 与 Kimi 的专用文件、搜索工具使用下表的地址。仅使用 Zaokit Key，不要在客户端填写供应商密钥。

新增直连渠道面向 default 分组。已有专属分组和套餐的权限没有自动扩大。模型列表中的 glm-file-parser、kimi-file-extract 等是专用工具的权限与计费名称，不是聊天模型。

下载上游接口参考目录

该目录是上游接口参考，不代表每项已在 Zaokit 开通。查看本次模型登记与验证记录；实时权限以携带自己 Key 查询 /v1/models 的结果为准。百炼兼容模型列表不包含全部独立视频、语音服务，不能把它当作所有接口的完整清单。

万相视频已通过正式入口完成生成。先提交，再使用返回的 id 查询。收到编号仅表示已受理；只有任务状态为 SUCCESS 且结果文件可播放，才算生成成功。

: "${ZAOKIT_API_KEY:?请设置 Zaokit Key}"
curl --fail-with-body "https://api.zaokit.com/v1/video/generations" \
  -H "Authorization: Bearer $ZAOKIT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"wan2.2-t2v-plus","prompt":"蓝色小球在白色地面上缓缓滚动","size":"832*480","duration":5}'

# 把提交返回的 id 保存到 ZAOKIT_TASK_ID，再查询。
: "${ZAOKIT_TASK_ID:?请设置提交结果中的 id}"
curl --fail-with-body "https://api.zaokit.com/v1/video/generations/$ZAOKIT_TASK_ID" \
  -H "Authorization: Bearer $ZAOKIT_API_KEY"

当前查询返回外层 code 和 data。读取 data.status 与 data.progress；成功时视频链接位于 data.data.output.video_url。链接有有效期，请及时保存。失败时检查返回错误，不要无限重新提交。

wan2.2-t2v-plus 本次验证使用 832*480、5 秒。这个版本不接受 1280*720，其他型号的参数不能直接套用。GLM 视频已验证供应商生成成功，但其视频入口尚未接入当前正式网关；不要使用尚未发布的 GLM 视频地址。

百炼视频参数参考

GLM 已通过真实 PDF 与文本文件的内容核对。Kimi 的 PDF 样例提取了标记和数值，但遗漏了币种文字，不能视为完整通过；当前请优先使用 GLM，Kimi 官方账户状态见上方说明。解析文件与让模型回答文件内容是两个步骤。上传成功不代表已经提取到正文；扫描件还需要 OCR。请按所选服务的文件类型、大小和页数限制上传。

GLM：直接上传并提取正文

: "${ZAOKIT_API_KEY:?请设置 Zaokit Key}"
curl --fail-with-body "https://api.zaokit.com/providers/glm/api/paas/v4/files/parser/sync" \
  -H "Authorization: Bearer $ZAOKIT_API_KEY" \
  -F 'file=@./document.pdf' \
  -F tool_type=prime-sync \
  -F file_type=PDF

成功时 status 为 succeeded，content 包含提取出的正文。单次请求上限 20 MiB，已使用实际 PDF 核对文字与金额。

Kimi：上传后提取正文（待账户恢复）

ZAOKIT_PROVIDER_BASE="https://api.zaokit.com/providers/kimi"
: "${ZAOKIT_API_KEY:?请设置 Zaokit Key}"
curl --fail-with-body "$ZAOKIT_PROVIDER_BASE/v1/files" \
  -H "Authorization: Bearer $ZAOKIT_API_KEY" \
  -F purpose=file-extract -F 'file=@./document.pdf'

# 将上传结果中的 id 保存为 ZAOKIT_FILE_ID。
: "${ZAOKIT_FILE_ID:?请设置上传结果中的 id}"
curl --fail-with-body "$ZAOKIT_PROVIDER_BASE/v1/files/$ZAOKIT_FILE_ID/content" \
  -H "Authorization: Bearer $ZAOKIT_API_KEY"

当前专用入口单次上传请求上限为 20 MiB（含表单内容），Kimi 上传仅接受 purpose=file-extract。文件归属于创建它的 Key；其他 Key 即便在同一付费账号下，也不能读取或删除该文件。提取出的正文可作为后续对话上下文；需要控制上下文长度。Kimi 的图片理解使用专门的图片输入方式，不把图片当作 file-extract 文档。

GLM：文件解析与 OCR

同步解析使用 POST /api/paas/v4/files/parser/sync，以表单上传 file 并设置 tool_type=prime-sync。当前正式入口提供同步解析，返回 content 正文；异步解析尚未开放。GLM-OCR 使用 POST /api/paas/v4/layout_parsing，已验证官方样例图的文字提取；它与通用文件提取接口不同。

百炼：文件问答与文档模型

文件问答、Qwen-Doc 和知识库解析分别属于不同功能。智能体文件问答需要先发布应用并设置文件处理方式；不能仅凭语言模型已开通，就认为文档解析也已开通。

Kimi 文件接口 · GLM 文件解析 · 百炼文件问答

GLM 独立搜索与百炼联网问答已通过正式入口验证。Kimi 搜索曾验证成功，但当前官方入口受阻，需恢复账户后复测。独立搜索返回网页结果，联网问答返回模型结合搜索后的回答。验证时应检查真实来源链接、内容与时效，不能只看模型有没有声称“已搜索”。

GLM：独立搜索

ZAOKIT_PROVIDER_BASE="https://api.zaokit.com/providers/glm"
: "${ZAOKIT_API_KEY:?请设置 Zaokit Key}"
curl --fail-with-body "$ZAOKIT_PROVIDER_BASE/api/paas/v4/web_search" \
  -H "Authorization: Bearer $ZAOKIT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"search_engine":"search_std","search_query":"阿里云百炼 API 官方文档","search_intent":false,"count":5}'

GLM 网页正文读取使用 POST /api/paas/v4/reader，发送 {"url":"待访问的公开网页地址"}，读取返回的 reader_result。此入口也已验证。

Kimi：搜索与网页抓取（待恢复）

POST /v1/tools/search 使用 text_query 与 limit 等参数；增强搜索为 /v1/tools/search_pro，网页正文抓取为 /v1/tools/fetch；这些入口完成过正式验证，但 Kimi 官方账户当前受阻，不能作为当前可用承诺。对话内的搜索工具应按当前模型文档选择；需要工具结果回传时，完成整个调用循环后才会得到最终回答。

百炼：模型联网问答

在支持的模型请求中启用 enable_search。使用兼容 SDK 时通过扩展请求体传入；部分多模态模型要求流式调用。Responses 的搜索工具与普通对话参数不同，请按对应接口配置。

GLM 网络搜索 · Kimi 搜索 · 百炼联网搜索

专用说明入口：/docs/token-plan。正式 API 根地址统一为 https://api.zaokit.com。已发放的 Zaokit Key 继续使用；本次没有创建第二套套餐地址，也没有修改已有密钥的额度规则或分组。已确认现有专属密钥关联月度额度配置，部分密钥另有请求频率限制。新增工具是否纳入这些套餐尚待确定，当前不自动扩大套餐权益；具体额度以发放的配置为准，不要自行添加 /plan。

Zaokit 的套餐、阿里云套餐、GLM Coding Plan 和 Kimi 订阅是不同产品。购买其中一个，不代表可以把对应密钥用于其他产品，也不代表所有视频、音频或搜索费用都包含在套餐内。