Sakrylle Image

image.sakrylle.com 是 Sakrylle 官方的在线图像生成与编辑站，覆盖文生图、参考图编辑、蒙版重绘、Agent 多轮对话生图。技术栈为 React 19 + TypeScript + Vite 6 + Zustand，纯前端 SPA。历史与画廊数据主要存储在浏览器本地，关闭页面前请确认重要图片已下载。

• 在线访问：https://image.sakrylle.com
• 控制台：https://ai1.sakrylle.com
• 当前版本：0.11.4

计费速览

• 可用图像模型：gpt-image-2（GPT-Image 分组，￥0.15/次）
• 计费方式：按成功调用次数计费，失败请求不扣费
• 所属分组：图像模型按分组隔离，对应控制台 API Key 必须绑定该模型所在分组
• 流式模式下若开启「请求中间步骤图像」，中间图作为同一次请求的一部分返回；实际扣费以控制台账单为准

一个 API Key 只能绑定一个分组。一键登录（OAuth）会自动拉取你账号下可用的分组与模型；如果用手动 Key，要用哪个图像模型就绑定它所在的分组。同时要用 GPT-Pro 聊天模型与图像模型时，需要在控制台分别创建多把 Key。

实际计费以控制台为准。

登录

进入 image.sakrylle.com，点击右上角设置图标打开设置面板，切到 API 配置 标签。

一键登录

1. 点击 使用 Sakrylle 账户登录
2. 浏览器跳转 oidc1.sakrylle.com 完成授权（OAuth 2.0 Authorization Code + PKCE）
3. 授权成功后自动跳回站点
4. 余额、模型列表会自动拉取，无需手填 API Key

授权 token 存在浏览器 localStorage，过期前 60 秒会静默刷新。点击 注销 可立即清除本地 token；注销后画廊与历史不会被清空。

OAuth Bearer 自动回退

未配置手动 API Key 时，站点会自动使用 OAuth 登录获取的 access_token 作为 Bearer token 发起请求。如果同时配置了手动 Key，手动 Key 优先。

手动配置 API Key

如果你不想走 OAuth，或者公司网络环境拦了授权回跳：

1. 在控制台创建一个绑定 GPT-Image 分组的 API Key
2. 在设置面板 API Key（手动） 字段粘贴 Key
3. API URL 保持默认 https://api.sakrylle.com/v1
4. 模型 ID 保持默认 gpt-image-2
5. API 接口 保持默认 Images API

已经登录 OAuth 时，手动 Key 字段会被忽略。要切回手动 Key，请先注销，或新建一个不登录的配置。

URL 一键导入

可以把配置打包到 URL 里：

https://image.sakrylle.com/?apiKey=sk-xxxxxxxxxxxxxxxx&model=gpt-image-2

支持的查询参数：apiKey、model、apiMode（images 或 responses）、streamImages、streamPartialImages。

画廊模式

画廊是站点的主界面，所有生成任务以卡片形式排列在画廊中。支持搜索、筛选、选择和批量操作。

文生图

最简流程：

1. 在底部输入框写提示词，例如 一只穿红色围裙的柴犬在京都樱花树下烤年糕
2. 右下角 生成 按钮提交
3. 任务卡片立即出现在画廊，等结果返回后展开预览

可选参数（提交前在输入栏附近调整）：

• 数量：单次最多 10 张；内部最多 6 个 worker 并发执行
• 尺寸：界面提供多种尺寸与宽高比预设（1:1、3:2、2:3、16:9、9:16、4:3、3:4、21:9），实际支持范围以 gpt-image-2 当前能力为准
• 质量：auto / low / medium / high（auto 模式由模型自动决定）
• 输出格式：PNG / JPEG / WebP
• 压缩：可调压缩比
• 透明背景：输出 PNG 时可选透明背景

提交后任务并发执行，互不阻塞——你可以连续投放多个任务进画廊排队。

参考图编辑

替换式编辑

无需画蒙版，模型整体重绘：

1. 点击输入框左侧的图片图标，上传一张参考图（或直接拖入）
2. 写提示词描述要怎么改，例如 把背景换成黄昏的海边
3. 生成

支持同时上传最多 16 张参考图，支持拖放和粘贴上传。上传 HEIC 格式图片时会自动转换为 JPEG。

蒙版重绘

1. 上传参考图后，点参考图缩略图右上角的笔刷图标
2. 进入蒙版编辑器，用画笔涂出要重绘的区域
3. 调整画笔大小 / 切换橡皮 / 一键反选
4. 确认后回到主界面，写提示词描述新的局部内容
5. 生成——只有蒙版覆盖的区域会被改写，其余像素保留

设置 → 习惯配置 → 参考图编辑按钮 可以选默认行为：每次询问 / 直接替换参考图 / 直接进入蒙版。

图片提及

在提示词中可以用 @图1 引用当前上传的参考图；Agent 历史图可以用 @第1轮图1 这类格式引用。

多图并发生成

当生成数量大于 1 时，站点会自动将请求拆分为多个并发单图请求（最大并发数 MAX_CONCURRENT = 6），每个请求独立执行、独立返回。任务卡片会实时显示各张图的生成进度。

流式与中间图像

设置 → API 配置 → 流式传输 控制是否使用 SSE 流式接口：

• 关闭：等模型出完整图再返回，适合单图、网络稳定场景
• 开启：边生成边推送中间步骤；可视化效果更好，长任务更不易超时

开启流式后，请求中间步骤图像数（partial_images，0--3）控制中间图数量：

• 0：不请求中间图——连接可能因长时间无数据被代理断开
• 2 或 3（推荐）：稳定看到生成过程
• 中间图作为同一次请求的一部分返回，实际扣费以控制台账单为准

Sakrylle 上游对 gpt-image-2 的流式只支持单图。批量生成（数量 > 1）时会自动拆成并发单图请求。

任务管理

搜索与筛选

画廊顶部提供搜索栏，可按提示词内容搜索任务。支持按任务状态（排队中、生成中、已完成、失败）筛选。

选择与批量操作

• 拖选：在画廊空白区域按住鼠标拖拽，框选多个任务卡片
• Ctrl/Cmd + 点击：单个追加/取消选择
• 选中后可执行：批量下载（打包为 ZIP）、批量删除

右键菜单

在任务卡片或生成的图片上右键，弹出上下文菜单，可执行复制、下载、删除等操作。

图片拖拽排序

画廊中的图片支持拖拽重新排列顺序。

收藏与收藏夹

收藏任务

点击任务卡片上的收藏按钮（星标），可将任务加入收藏。

收藏夹管理

• 创建收藏夹：给收藏夹命名，用于分类管理收藏的任务
• 重命名 / 删除收藏夹
• 收藏夹排序：拖拽调整收藏夹顺序
• 将任务分配到收藏夹
• 批量操作：选中多个任务批量移入/移出收藏夹

Agent 多轮对话

Agent 模式让你像聊天一样多轮迭代图像：模型可以在一次对话里读上一轮的图、调用 image_generation 工具续画、做网络搜索补充上下文。

前置条件

Agent 模式背后走的是 Responses API，需要一个支持 image_generation 工具的文本模型（不是 gpt-image-2 本身）。默认设置下 Agent 模式不可用，必须先在设置里手动切到 Responses API。

Agent 模式需要一个 GPT-Pro 分组的 Key（不同于图像生成用的 Key），因为 Agent 对话本身走的是文本模型计费。

配置步骤

1. 在控制台创建一个绑定 GPT-Pro 分组的 API Key
2. 进设置面板 → API 配置
3. 点击 创建新配置（或在当前配置上修改），填：
   • API Key：粘贴刚才那把 GPT-Pro Key
   • API 接口：切到 Responses API
   • 模型 ID：填 gpt-5.5（或其他支持 image_generation 工具的文本模型）
   • 流式传输：建议开启
   • 请求中间步骤图像数：建议 2 或 3，避免长任务被超时断开
4. 切回主界面顶部，把模式切到 Agent
5. 输入提示词开始多轮对话

没切到 Responses API 就开 Agent 会得到 model not found 或 tool not supported 类错误。这是最常见的踩坑。

对话管理

• 对话历史：所有对话轮次保存在本地，可随时回看
• 重命名对话：给对话起个有意义的名字便于查找
• 分支：可以从任意一轮对话处分叉出新对话，尝试不同方向

Agent 可选项

• 最大工具调用轮数（设置 → Agent 配置）：1--50，默认 15。防止模型陷入死循环时无限调用工具
• 网络搜索（设置 → Agent 配置）：开启后允许模型在对话中调用 web_search 工具，每次额外计费
• 停止生成：生成过程中可随时点击停止按钮中断当前生成
• 自动滚动：新消息到达时自动滚动到最新位置

流式 Markdown 渲染

Agent 对话中的文本响应支持流式渲染，包括：

• Markdown 格式（标题、列表、加粗、链接等）
• 代码块（带语法高亮）
• KaTeX 数学公式渲染
• 表格

设置

设置面板包含 5 个标签页。

API 配置

设置项	说明
供应商选择	选择 API 供应商（Sakrylle 或自定义）
API URL	API 端点地址，默认 https://api.sakrylle.com/v1
API Key	手动填入的密钥
模型 ID	使用的模型标识符
API 接口	Images API 或 Responses API
流式传输	开启/关闭 SSE 流式
配置管理	创建/切换/删除配置（profiles）
分组选择	选择绑定的 API Key 分组

自定义供应商

支持通过 JSON 清单文件添加自定义 API 供应商。

Codex CLI 兼容模式

支持与 Codex CLI 配合使用。

习惯配置

设置项	说明
提交模式	Enter 发送 / Ctrl+Enter 发送
清空输入	提交后是否自动清空输入框
参考图编辑按钮	每次询问 / 直接替换参考图 / 直接进入蒙版
ZIP 下载路由	批量下载 ZIP 的存储路径
通知	浏览器通知开关

Agent 配置

设置项	说明
最大工具轮数	1--50，默认 15
网络搜索	开启/关闭

数据管理

设置 → 数据管理 提供：

• 导出：把所有配置、历史、对话打成 ZIP 包（含全部数据）
• 导入：从 ZIP 文件恢复
• 清空：清掉所有本地数据（不可逆）

换设备前先导出再到新设备导入，是目前唯一的迁移方式。

关于

显示版本信息、上游仓库链接、许可证等。

外观与本地化

深色/浅色主题

支持深色和浅色两种主题，切换时使用 View Transition API 实现平滑过渡动画。

语言切换

支持中文（zh）和英文（en）两种语言，可在界面中直接切换。

PWA 与本地数据

安装为应用

支持 PWA 的浏览器（Chrome / Edge / Safari 16.4+）地址栏会显示「安装」图标，点一下即可装到桌面。装后离线也能开 UI，但生成本身仍需联网。

本地数据

• 历史任务、画廊缩略图和 Agent 对话主要保存在浏览器本地数据库；登录 token、主题、语言、分组选项和部分设置保存在浏览器本地存储 / 会话存储
• 没有云同步，换浏览器 / 清缓存 / 隐身模式都会读不到旧数据
• 重要图请用任务卡片上的下载按钮另存到本地

余额显示

登录后，页面头部会显示当前账户余额，方便随时查看消费情况。

多组 OAuth

如果你同时需要图像生成和 Agent 对话功能，需要在控制台分别创建不同分组的 Key：

• GPT-Image 分组（group_id=5）：用于文生图和参考图编辑（Images API）
• GPT-Pro 分组：用于 Agent 多轮对话（Responses API）

OAuth 登录时会自动拉取账号下所有可用分组，站点会根据当前模式自动选择合适的 Key。

常见问题

• 401 invalid_api_key：Key 错了 / 已删 / 过期。回 API Keys 重建一个
• 402 余额不足：到 计费与充值 充值
• 403 Image generation is not enabled for this group：当前 Key 没绑 GPT-Image 分组（Images API 模式必须）。在控制台新建一个 GPT-Image 分组的 Key
• Agent 模式报 model not found / tool not supported：API 接口没切到 Responses API，或模型 ID 仍是 gpt-image-2。改成 gpt-5.5 这类支持 image_generation 工具的文本模型
• 流式生成卡住、长时间无进度：中间步骤图像数设成了 0。改成 2 或 3 后重试
• 登录后回到站点仍未登入：浏览器拦了 OAuth 回跳，或第三方 Cookie 被禁。改用手动配置 API Key
• 画廊空了：浏览器清缓存 / 切了无痕 / 换设备，本地 IndexedDB 数据已丢，无法恢复。如有导出过 ZIP 可在 数据管理 导入

相关文档

• API Keys — 创建并管理你的 Key
• 计费与充值 — 了解按次计费的扣款逻辑
• 模型与计费 — 全模型价格表
• Images API — 直接用 API 调图像生成