推荐：如果你已经安装过 CC Switch，直接跳到第二步。
01
下载安装 CC Switch
先下载并安装 CC Switch。下载入口是统一发布页，不分 Windows / macOS 页面；打开后按自己的系统选择对应文件。已经安装过的用户，可以跳过这一步。
| 文件类型 | 怎么选 |
|---|
| Windows.msi | 推荐普通用户下载，双击安装。 |
| Windows-Portable.zip | 便携版，解压后运行，适合不想安装或没有安装权限的电脑。 |
| 文件类型 | 怎么选 |
|---|
| macOS arm64 .dmg | Apple 芯片 Mac 使用，例如 M1 / M2 / M3 / M4。 |
| macOS x64 .dmg | Intel 芯片 Mac 使用。 |
- 下载后打开 .dmg，拖入 Applications 后启动。
安全提示：优先从官方站、GitHub Releases 或源码仓库下载。不要使用要求付费、充值或索取账号密码的“CC Switch”下载站。
02
创建 968 API Key
回到 968 API 控制台，点击“创建 API Key”。创建完成后，在 Key 的分组右侧点击“导入”，系统会自动拉起 CC Switch。
- 普通聊天模型：使用普通 Key。
- 图片模型：使用图片模型 Key。
- 如果没有拉起 CC Switch，先确认电脑已经安装 CC Switch，再回到控制台重新点击“导入”。
03
填写 968 API 配置
使用“导入”按钮时，下面内容会自动带入 CC Switch；如果需要手动填写，就按这个表格填。
| 字段 | 填写内容 | 说明 |
|---|
| 名称 | 968 API | 用于在 CC Switch 里识别这组配置。 |
| Base URL | https://yh.968968968.xyz/v1 | 必须带 /v1。 |
| API Key | sk-... | 填入你刚刚创建的完整 Key。 |
{
"name": "968 API",
"baseUrl": "https://yh.968968968.xyz/v1",
"apiKey": "sk-你的完整Key"
}04
保存后测试
保存配置后，在 CC Switch 里切换到 968 API，选择一个模型，发送一句简单测试消息。
- 能正常返回内容，说明 Base URL 和 Key 都没问题。
- 提示未授权：重新复制完整 Key，确认没有空格。
- 提示模型不可用：回到模型目录确认当前分组是否包含该模型。
05
以后怎么更新
如果你重新创建了 Key、切换了分组，或者模型列表有更新，回到控制台点击对应 Key 右侧的“导入”，重新导入到 CC Switch 即可。
如果你想手动维护，也可以在 CC Switch 里直接修改这组 968 API 配置。
- 连接失败：检查 Base URL 是否为 https://yh.968968968.xyz/v1，不要漏掉 /v1。
- 401 或未授权：重新复制完整 API Key，确认没有空格或换行。
- 模型不可用：换一个当前分组可见的模型，或在控制台切换 Key 的分组。
- 余额不足：先充值或给当前 Key 分配额度。
非常重要：图片接口必须使用图片模型 Key，普通聊天 Key 不能调用。
01
接口概览
| 接口 | 方法 | 用途 |
|---|
| /images/generations | POST JSON | 文生图，根据提示词生成图片。 |
| /images/edits | POST JSON / multipart | 图生图、参考图编辑、遮罩编辑，支持 URL 或文件上传格式。 |
02
文生图 JSON 示例
服务端可直接按 JSON 方式调用，返回图片 URL。
curl https://yh.968968968.xyz/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A premium black diamond product render on a clean white background",
"size": "1024x1024",
"n": 1,
"response_format": "url"
}'03
图生图 JSON URL 示例
已有可用图片 URL 时，可直接传入 image 字段。
curl https://yh.968968968.xyz/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Make the product more glossy and premium",
"image": "https://img.968968968.xyz/i/reference.png",
"size": "1024x1024",
"n": 1,
"response_format": "url"
}'04
multipart 文件上传示例
本地图片编辑建议直接使用文件上传。
curl https://yh.968968968.xyz/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=gpt-image-2" \
-F "prompt=Turn this into a premium product poster" \
-F "size=1024x1024" \
-F "n=1" \
-F "response_format=url" \
-F "image=@reference.png;type=image/png"
05
图片请求参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|
| model | string | 是 | 图片模型名称，例如 gpt-image-2。 |
| prompt | string | 是 | 文本提示词，描述你要生成或编辑的图片目标。 |
| image | string / file | 图生图必填 | 编辑接口使用。支持平台认可的临时 URL，或 multipart 上传本地文件。 |
| size | string | 否 | 图片尺寸，按 1K / 2K / 4K 分辨率档位计费。必须使用文档支持的尺寸。 |
| response_format | string | 否 | 推荐使用 url。不要读取 b64_json。 |
支持的图片尺寸：请按后台已开放档位选择使用。
06
常见报错排查
- image_key_required：表示用了普通 Key，需要换成图片模型 Key。
- invalid_size：表示尺寸不支持，请改成文档支持列表内的尺寸。
- invalid_image_url：图生图 URL 不支持，建议改用 multipart 文件上传。
- invalid_image_route：传了不可用的 route_id，删除 route_id 让系统自动选择即可。
- insufficient_balance：表示图片 Key 额度不足。
01
安装 Git Bash（推荐）
Windows 下建议使用 Git Bash 运行 Claude Code。
已安装 Git Bash？可以直接跳过此步骤。
终端准备
macOS 和 Linux 可直接使用系统终端。
02
安装 Node.js
Claude Code 需要 Node.js 18 或更高版本。请先执行：
03
获取 API 密钥
前往控制台创建新的 Key，并复制保存。
04
安装客户端
npm install -g @anthropic-ai/claude-code
05
配置 settings.json
打开或创建 ~/.claude/settings.json，填入以下内容：
{
"apiBaseUrl": "https://yh.968968968.xyz/v1",
"apiKey": "sk-xxxxxx..."
}07
常见问题
Q: 为什么提示 API 连接超时或 401 未授权？
A: 检查 apiBaseUrl 是否正确，且 apiKey 是否复制完整、没有多余空格。
说明：先按官方方式安装，再改写接入配置。
01
安装 Codex CLI
npm install -g @openai/codex
# 或者使用 Homebrew（仅 macOS）
brew install codex
npm install -g @openai/codex
02
创建 .codex 目录
rm -rf ~/.codex
mkdir ~/.codex
Remove-Item -Recurse -Force ~\.codex -ErrorAction SilentlyContinue
New-Item -ItemType Directory ~\.codex
03
获取 968 API 密钥
前往控制台创建新的密钥，后续写入配置文件。
04
创建 auth.json
{
"api_key": "sk-xxxxxx..."
}05
创建 config.toml
设置 base_url 后，请求将发送到 968 API：
[api]
base_url = "https://yh.968968968.xyz/v1"
[model]
default = "gpt-4o"
01
在线调试
选择 API Key 和模型后，输入测试消息即可开始调试。
请求配置
