Help Center

图话匣 AI Image Relay 使用帮助

图话匣是一款面向第三方 AI 作图接口的本地化 Chrome 扩展，支持 gpt-image-2 兼容接口，也支持你自己切换到其他常见绘图模型。接口信息、会话记录、生成历史与附件全部保存在本地 IndexedDB。

⬇️ 下载发布版 ZIP 🔐 隐私政策

快速开始

  1. 点击右上角设置，进入接口管理。
  2. 添加一个接口，填写接口名称、API Base URL、API Key 和模型名称。
  3. 保存后回到主界面，选择接口，输入提示词，点击“生成图片”。
  4. 如果需要参考图，可直接粘贴图片到提示词输入框，或在“更多参数”中上传参考图与蒙版。

接口配置说明

接口名称 仅用于你自己在本地识别和切换接口，不参与真实请求。
API Base URL 填写第三方中转地址即可。扩展会自动兼容常见的 /v1 结尾写法。
模型名称 这里填写真实发起请求时要用到的模型 ID，例如 gpt-image-2。
默认参数 尺寸、质量、输出格式等默认值保存在接口里。主界面切换接口后会自动带出，但你仍可在生成前临时修改。

支持的生成方式

  • 文生图：只输入提示词，直接生成。
  • 参考图生成：可上传多张参考图，也可像 ChatGPT 一样直接粘贴图片。
  • 蒙版编辑：上传参考图后，再补一张蒙版图，交给支持编辑能力的上游模型处理。

本地记录与安全

会话记录本地保存 所有会话、提示词、图片结果和附件元数据都保存在本地 IndexedDB，不上传到图话匣自己的服务器。
可删除单条或整个会话 你可以删除单条记录，也可以删除整个会话；清空全部时，会连同本地图像记录一起移除。
字体版权限制 勾选“仅用免费可商用字体，避开付费商用字体”后，扩展会把这条要求一并发给上游模型，用来降低营销图、海报图的字体版权风险。

常见问题

为什么点击生成后提示 Upstream request failed？ 这通常是上游接口返回失败。请先检查 Base URL、API Key、模型名称是否正确，再用“测试连通”确认当前接口状态。
参考图和蒙版为什么有时不生效？ 不是所有上游模型都支持图生图或蒙版编辑。是否支持，取决于你接入的第三方通道与实际模型能力。
为什么我修改了主界面的尺寸或质量，但接口默认值没变？ 主界面中的参数属于本次生成的临时覆盖，不会反写到接口配置里。接口默认值需要在设置中修改。
接口连通自检会消耗生成次数吗？ 图话匣的连通自检设计目标是不走正式生成流程，只做轻量探测；但最终是否计费，仍取决于你接入的第三方服务商实现方式。

安装使用说明

这份说明面向正式发布版使用者。请先解压安装包，然后在 Chrome 中加载其中的 dist 文件夹。下方配图已经做过裁切和整理，只保留关键操作区域。

说明中不展示本机路径、个人账户信息和无关扩展信息；请你在自己的电脑上按相同步骤操作即可。

一、安装扩展

01 打开扩展程序页 在 Chrome 地址栏输入 chrome://extensions/ 并回车，进入“扩展程序”页面。
02 开启开发者模式 在页面右上角打开“开发者模式”。打开后，页面顶部会显示加载本地扩展所需的按钮。
03 加载已解压的扩展程序 点击页面左上方的“加载已解压的扩展程序”，准备选择你解压后的插件目录。
04 选择 dist 文件夹 在目录选择器中，进入你解压后的插件文件夹，选中其中的 dist 文件夹后确认。正式版请不要选择源码根目录，也不要选择 dist-internal 。

二、首次配置接口

05 打开图话匣 安装成功后，建议先把扩展固定到工具栏。点击图话匣图标，即可打开主界面。
06 进入接口设置 点击界面右上角的齿轮按钮，进入“接口设置”。如果当前还没有任何接口，会直接进入添加接口流程。
07 点击添加接口 在接口管理页点击“添加接口”，进入配置表单。
08 填写基础信息并保存 依次填写接口名称、API Base URL、API Key 和模型名称。模型名称建议填写你实际要调用的模型 ID，例如 gpt-image-2 。保存后，接口会出现在列表中。

三、开始生成图片

选择已添加的接口 回到主界面后，在顶部接口下拉框中选择你刚刚保存的接口。
输入提示词 在输入框中直接写明你想生成的图片内容。需要参考图时，可粘贴图片或使用上传入口补充。
点击生成图片 确认接口、尺寸、质量和输出格式后，点击“生成图片”。生成中的任务会先进入当前会话，成功后自动回填结果。

关键操作示意

开启开发者模式示意图
在扩展程序页右上角打开“开发者模式”。打开后，Chrome 才会允许加载本地解压扩展。
选择 dist 文件夹示意图
在目录选择器中，请选择正式版的 dist 文件夹。这个文件夹就是需要加载到 Chrome 中的扩展目录。
打开添加接口示意图
安装完成后，进入接口设置，点击“添加接口”，即可开始填写你的第三方接口信息。

接口填写示例

推荐填写顺序

接口名称 我的图片接口
API Base URL https://api.example.com
API Key sk-********************************
模型名称 gpt-image-2

以上仅为格式示例。正式使用时，请替换成你自己的接口地址、密钥和模型 ID。主界面里临时改尺寸或质量，只影响当前这一次生成，不会反写到接口默认值。

正式版使用提醒

默认加载 dist 正式发布包默认使用 dist 文件夹；只有内部测试版才会使用其它目录。
接口信息仅保存在本地 你填写的接口地址、模型名称、密钥和会话记录都会保存在当前浏览器本地 IndexedDB 中，不会同步到图话匣服务器。
报错先检查四项 如果生成失败，优先核对接口地址、API Key、模型名称，以及该模型是否真的在当前第三方通道中可用。