GPT Image Playground 预置配置 JSON 完全参考3 种方式为团队批量注入 AI 绘图配置【免费下载链接】gpt_image_playground基于 OpenAI gpt-image-2.5 API 的图片生成与编辑工具项目地址: https://gitcode.com/gh_mirrors/gp/gpt_image_playgroundGPT Image Playground 是一款基于 OpenAI gpt-image-2.5 API 的开源图片生成与编辑工具支持文本生图、参考图与遮罩编辑。当你要为整个团队部署这个 AI 绘图 Web 应用时逐个让用户手填 API 地址和模型实在太繁琐——预置配置 JSON就是解决这个问题的钥匙部署端预先写好一份配置文件所有用户打开页面就能直接用只需补上自己的 API Key 即可开始生图。预置配置能帮你做什么部署即开画用户打开页面自动看到预置的 API 配置列表无需手动创建。密钥不落地配置中省略apiKey字段真实 Key 由每位用户在自己浏览器中填写数据纯本地存储团队共享部署但互不暴露密钥。可远程更新后续重新部署时修改过的参数API 地址、模型、超时等会自动覆盖一次本地值之后保留用户的本地修改直到部署值再次变更。Agent 也能预置可为 Agent 多轮对话模式单独指定文本模型与图像模型配置。默认情况下未开启锁定预置配置支持拖动排序与删除API 地址、模型等参数在部署值变化时会更新一次API Key 始终由用户本地管理、永不覆盖。三种填写方式覆盖所有部署场景预置配置统一由环境变量VITE_DEFAULT_API_URL构建时适用于 Vercel / GitHub Pages / Cloudflare / 本地或DEFAULT_API_URLDocker 运行时提供值支持三种写法填写方式适用场景示例直接填 API 地址只提供一个 OpenAI 兼容配置https://api.openai.com/v1API 地址 查询参数预填 Key、模型等字段https://api.openai.com/v1?modelgpt-image-2.5-sunburstapiModeimagesJSON 文件 / 导入链接预置多个配置、自定义供应商./gpt-image-config.example.json或https://example.com/presets.json第一种方式会自动创建一个 ID 为default-openai的默认预置配置其余参数使用应用默认值。第二、三种方式中构建脚本会读取文件内容并内嵌到静态页面中——见 vite.config.ts 的embedDefaultConfig实现Docker 镜像则在容器启动时由 deploy/inject-api-url.sh 完成同样的注入。预置配置 JSON 字段参考JSON 对象有三个顶层字段profiles数组必填预置的 API 配置列表每项对应用户配置页中的一个条目customProviders数组可选自定义供应商定义仅使用内置供应商时可省略agent对象可选Agent 模式的独立 API 配置选择。profiles配置列表字段字段必填说明id定向更新时填写配置唯一标识后续携带相同 ID 的链接/配置将直接更新该条目而非新建name✅配置名称方便用户识别description-配置说明支持 Markdown会显示为当前配置下方的说明卡片provider✅openaiOpenAI 兼容/sb2api-asyncsub2api 异步/falfal.ai/ 自定义供应商 IDbaseUrl✅API 基础地址不以/结尾时自动补/v1前缀fal.ai 可留空apiKey-建议省略让用户导入后自行填写model✅默认模型 IDimageGenerationModel-Responses API 的image_generation工具模型默认gpt-image-2.5-sunburstapiMode-images或responses默认imagesisDefault-多个配置时指定默认项只能有一个决定首次使用自动选中哪个timeout-请求超时秒数默认 600apiProxy-是否走部署端 API 代理默认falsetransparentBackgroundMethod-透明背景方式api原生或local本地后处理最小示例单个 OpenAI 兼容配置{ profiles: [ { id: my-openai, name: 我的 OpenAI 配置, description: 使用前请阅读接口说明。, provider: openai, baseUrl: https://api.openai.com/v1, model: gpt-image-2.5-sunburst } ] }只有一个配置时无需填写isDefault它会自动成为默认预置配置。仓库内提供了可直接参考的模板gpt-image-config.example.json。多配置示例OpenAI sub2api fal.ai 一站接入{ profiles: [ { id: openai-main, name: OpenAI, provider: openai, baseUrl: https://api.openai.com/v1, model: gpt-image-2.5-sunburst, isDefault: true }, { id: sub2api-profile, name: sub2api 异步, provider: sb2api-async, baseUrl: https://api.example.com/v1, model: gpt-image-2.5-sunburst }, { id: fal-profile, name: fal.ai, provider: fal, baseUrl: , model: openai/gpt-image-2 } ] }预置 Agent 配置文本与图像模型分离Agent 多轮对话模式的apiConfigMode有三种取值off沿用当前 API 配置native文本模型通过 Responses API 调用image_generation工具原生生图hybrid文本模型调用自定义工具再由独立的图像模型生成图片适合文本模型不支持原生图像工具的场景。在预置 JSON 中添加agent对象即可锁定团队默认的 Agent 方案{ profiles: [ { id: default-openai, name: 图像配置, provider: openai, baseUrl: https://api.example.com/v1, model: image-model, apiMode: images, isDefault: true }, { id: default-openai-agent, name: 文本配置, provider: openai, baseUrl: https://api.example.com/v1, model: text-model, apiMode: responses } ], agent: { apiConfigMode: hybrid, textProfileId: default-openai-agent, imageProfileId: default-openai } }其中textProfileId与imageProfileId均引用上方profiles的id文本配置必须使用 OpenAI 兼容的 Responses API。完整示例见 gpt-image-config.agent.example.json。团队部署4 种方式落地预置配置方式一Vercel / GitHub Pages构建时注入在Settings → Environment Variables / Secrets中设置VITE_DEFAULT_API_URL./gpt-image-config.example.json构建时自动读取仓库内的 JSON 模板并内嵌到页面。修改后需重新部署。方式二Cloudflare Workers在构建前设置VITE_DEFAULT_API_URLWorkers 不会在部署后改写静态文件必须构建前设置VITE_DEFAULT_API_URL./gpt-image-config.example.json npm run deploy:cf方式三Docker运行时注入宿主机文件挂载docker run -d -p 8080:80 \ -v ./gpt-image-config.json:/config/gpt-image-config.json:ro \ -e DEFAULT_API_URL/config/gpt-image-config.json \ ghcr.io/cooksleep/gpt_image_playground:latest⚠️ Docker 环境变量名为DEFAULT_API_URL不含VITE_前缀。宿主机上的 JSON 文件必须通过 volume 挂载进容器。方式四本地开发项目根目录新建.env.localVITE_DEFAULT_API_URL./gpt-image-config.example.json开发服务器启动或构建时远程.json文件或本地路径都会被自动内嵌到页面。团队管控锁定参数与限制删除部署端可用以下环境变量收紧权限构建时变量 / Docker 运行变量变量效果VITE_LOCK_PRESET_CONFIG_PARAMStrue/LOCK_PRESET_CONFIG_PARAMStrue锁定预置配置中除 API Key 外的所有参数禁止编辑预置供应商定义VITE_PREVENT_PRESET_CONFIG_DELETIONtrue/PREVENT_PRESET_CONFIG_DELETIONtrue禁止删除预置配置和预置供应商不锁定参数VITE_SHOW_PRESET_CONFIG_ONLYtrue/SHOW_PRESET_CONFIG_ONLYtrue只允许使用当前预置配置禁止创建、复制、删除、拖动、切换供应商参数未锁定时仍可编辑API Key 始终可编辑配合 Docker 的ENABLE_API_PROXYtrueLOCK_API_PROXYtrue还能隐藏真实 API 地址DEFAULT_API_URL留空或填占位地址真实上游地址仅存在于API_PROXY_URL用户看不到。预置策略的核心逻辑锁定、防删、回退实现在 src/lib/presetConfig.ts。进阶AI 一键生成自定义供应商配置当 API 不是标准 OpenAI 格式时需要在customProviders中定义请求与响应结构submit提交、poll轮询、result图片提取路径等。两种生成方式应用内 AI 生成进入设置 → API 配置 → 创建自定义供应商 → AI 一键生成与导入粘贴第三方 API 文档即可任意 LLM 手动生成参考 docs/custom-provider-llm-prompt.md 中的提示词把它和 API 文档一起发给任意大模型拿到完整 JSON 后填入预置配置文件。自定义供应商支持同步与异步任务两种模式异步任务供应商需配置taskIdPath与poll轮询imageUrlPaths支持*通配数组路径如data.result.images.*.url.*。快速核对清单 ✅profiles中每个配置都有唯一id、name、provider、baseUrl、model多配置时恰好一个isDefault: true单配置时省略该字段apiKey已省略留给用户自己填写非/v1路径的接口baseUrl以/结尾环境变量按部署方式选择构建时用VITE_DEFAULT_API_URLDocker 用DEFAULT_API_URL需要管控时追加LOCK_PRESET_CONFIG_PARAMS等锁定开关重新部署后验证参数覆盖是否符合预期掌握这份 JSON 参考你就能在 Vercel、GitHub Pages、Cloudflare 或 Docker 上用一条环境变量把 GPT Image Playground 的 AI 绘图配置批量注入给整个团队——用户打开页面补上 Key立刻开画。【免费下载链接】gpt_image_playground基于 OpenAI gpt-image-2.5 API 的图片生成与编辑工具项目地址: https://gitcode.com/gh_mirrors/gp/gpt_image_playground创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
