Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

4.6 KB
Raw Blame

自定义供应商的 OpenAI Images 接口

Cindy Gateway 已有的图片、视频目录继续跟随网关。自定义连接可单独启用 OpenAI Images 接口,让使用 Core 媒体能力的 Art 等插件调用自己的图片来源。 适配按接口契约复用,不按中转产品名分支。

使用方式

  1. 在供应商的连接设置中选中持有该图片来源的 Agent 连接,填写 API 地址与 API Key。 本机回环地址也可以使用无鉴权连接。
  2. 勾选「使用 OpenAI Images 接口」。只有实际提供下列两个端点的连接才应开启。 仅兼容对话接口,或订阅中能在网页上作图,不能证明该连接有 Images API。 开启后,此连接是该供应商唯一的图片连接,其他 Agent 的对话地址、模型与凭证保留。
  3. 获取模型列表;若供应商的 CLI 清单不包含图片模型,用原有手动添加入口填写真实模型 ID。 在供应商的模型列表打开该模型详情,在「能力」中选择「图片生成」或「图片生成与编辑」。 该声明只作用于已选的图片连接,不会按供应商或模型名称推测能力;仅选择接口实际支持的项。 「跟随模型目录」删除 mode、modalities 用户覆盖,重新使用供应商实报及公共默认资料。
  4. 重新打开 Art 详情,在图片生成、图片编辑能力中选用该来源的模型。

连接地址可以填写 API origin、以 /v1 结尾的地址或带路径前缀的 /v1 地址。 例如 http://127.0.0.1:8317/v1 对应 http://127.0.0.1:8317/v1/images/generations。 未以 /v1 结尾的地址会追加 /v1,路径前缀保留。

一期支持的契约

操作 接口 请求与响应
图片生成 POST /images/generations JSON;原样发送模型 ID、prompt,使用既有 OpenAI 图片参数规范化
图片编辑 POST /images/edits multipart;参考图与 model、prompt、size、quality
返回图片 data[0].b64_json 或 data[0].url 客户端下载、校验并保存为受管媒体

鉴权为该 Agent 连接的 API Key(Bearer),或仅本机回环地址的无鉴权模式。 不会借用其他 Agent、其他供应商或订阅登录的凭证。自定义业务请求头保留, 鉴权、账号、协议会话和 multipart 的请求头由客户端隔离或生成。 模型级地址覆盖必须与连接地址同源;付费提交不跟随重定向。 媒体模型由明确开启 Images 的连接提供,同名对话条目不会抢占来源。 手工配置中同名模型有多个 Images 连接时不选择任何一份凭证;在连接设置重新选择唯一图片连接即可恢复。 自定义通道在 JSON 解析前按实际流入字节限制整个响应为 32 MiB,错误响应同样受限。 URL 图片下载沿用独立的媒体下载流程,此响应限制不作为 URL 下载大小限制。

CPA/CLIProxyAPI、Sub2API 等自建中转只要提供上述契约即可复用此通道; 它们内部如何管理订阅或 CLI,不进入 Cindy 的媒体适配层。 是否能使用某个模型仍取决于中转实际开放的接口、模型及账号权限。

已安装用户与失败恢复

  • 新字段 imageApi: "openai-images" 为可选配置。缺省不启用,不自动改变已存连接或付费来源。
  • Gateway、OpenAI、Codex 和 xAI 既有通道优先保留;不替换原有原生订阅通道。
  • 本次不修改插件包、批准记录、权限指纹或凭证存储布局,无需重新安装或重新授权插件。
  • URL 结果先保存调用记录,再走既有下载许可与安全校验。下载不携带生成来源的 API Key。 下载失败后使用原 invocation 再次执行 request,只恢复同一结果,不重新付费生成。
  • 上游提交结果不确定时不自动重提,不自动换模型或换来源;拒绝与诊断文本脱敏后返回。
  • 新来源使用 Core 媒体能力;冻结的旧 cindy-request 同步接口不扩展自定义来源。 旧入口的模型清单和偏好均按通道的旧协议兼容性过滤,不能把仅支持 Core 的来源交给 base64 解码器。 旧插件已有能力保持原状。要使用新来源,插件需要采用 Core 媒体能力。

后续边界

自定义视频来源参见 xAI 兼容视频接口。图片通道不实现 原生 Gemini/其他私有图片协议、任意 CLI 进程驱动、 网页 Cookie 或私有订阅登录的复用,也不新增逐家 OAuth 适配。 只开放生成、缺少编辑端点的来源暂不应开启此选项。 新协议应独立评估其主流程度和稳定契约,避免在 OpenAI Images 通道上叠加供应商特例。