gpt_image_playground

用 GPT 图像模型，快速生成和编辑图片，开箱即用

gpt_image_playground 是一个基于 OpenAI gpt-image-2 API 的图片生成与编辑工具，采用 TypeScript 和 React 构建，前端使用 Vite 和 Tailwind CSS。它解决了开发者快速体验和集成 GPT 图像生成能力的问题，提供了直观的交互界面，支持文本生成图片、图片编辑、局部修改等功能。核心能力包括调用 gpt-image-2 模型进行高质量图像生成、通过自然语言指令编辑现有图片、以及灵活的 API 参数配置。项目结构清晰，适合作为参考实现或直接部署为演示应用，帮助用户理解 OpenAI 图像 API 的用法和最佳实践。

开源 unknown 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3767

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类图像生成

开发团队CookSleep

所属国家

官网地址https://gpt-image-playground.cooksleep.dev

GitHubhttps://github.com/CookSleep/gpt_image_playground

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型gpt-image,image-editing,image-generation,openai,react,tailwindcss,typescript,vite

GitHub 星标★ 3767

30天Star增速

HF 下载量

上线时间2026-04-23 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数7

使用教程

难度：入门约 15 分钟部署方式：Docker 6 步

环境要求

已安装 Docker（支持 docker run / docker compose）
已获取 OpenAI 兼容接口的 API Key
准备一个可用的 API 基础地址，如 https://api.openai.com/v1
服务器可访问 ghcr.io 拉取镜像

安装与启动步骤

1拉取并启动容器

用官方镜像启动服务，把容器 80 端口映射到宿主机 8080；DEFAULT_API_URL 填入你的 API 基础地址。
```
docker run -d -p 8080:80 -e DEFAULT_API_URL=https://api.openai.com/v1 ghcr.io/cooksleep/gpt_image_playground:latest
```
2改用 Compose 编排

若习惯 Compose，可写入 docker-compose.yml 后一键启动，并设置 restart 策略自动重启。
```
docker compose up -d
```

3挂载自定义配置

需要多个预置配置时，把本地 JSON 挂载进容器并让 DEFAULT_API_URL 指向该路径。

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

4开启同源 API 代理

浏览器直连被 CORS 拦截时，开启 Nginx 同源代理，请求经 /api-proxy/ 转发到 API_PROXY_URL。

docker run -d -p 8080:80 -e DEFAULT_API_URL= -e API_PROXY_URL=https://real-api.example.com/v1 -e ENABLE_API_PROXY=true -e LOCK_API_PROXY=true ghcr.io/cooksleep/gpt_image_playground:latest

5修改端口

默认监听 0.0.0.0:80，端口冲突时通过 PORT 变量改到其他端口。
```
docker run -d -p 8080:80 -e PORT=28080 ghcr.io/cooksleep/gpt_image_playground:latest
```
6浏览器打开并配置 Key

访问 http://localhost:8080 ，在页面里为预置配置补充 API Key 后即可开始生图。

关键配置

配置项	必填	说明	示例
`DEFAULT_API_URL`	是	预置配置的 API 地址，可为 URL、带查询参数 URL 或 JSON 文件路径	`https://api.openai.com/v1`
`ENABLE_API_PROXY`	否	开启 Nginx 同源代理，经 /api-proxy/ 转发以绕开 CORS	`true`
`API_PROXY_URL`	否	代理转发的完整 API 基础地址，不会自动补 /v1	`https://real-api.example.com/v1`
`LOCK_API_PROXY`	否	强制锁定代理为开启状态，用户无法在界面关闭	`true`
`HOST / PORT`	否	Nginx 监听地址和端口，默认 0.0.0.0:80	`28080`
`LOCK_PRESET_CONFIG_PARAMS`	否	锁定预置配置中除 API Key 外的参数，禁止编辑预置供应商	`true`

如何确认成功

容器启动后用 docker ps 确认运行中，浏览器访问 http://localhost:8080 能打开页面即成功。

常见问题

Q：国内访问 Vercel 分配的 .vercel.app 域名打不开？

A：Vercel 默认域名国内通常无法直连，可在 Settings → Domains 绑定自己的域名；或改用 Docker / GitHub Pages 方式部署。

Q：为什么调用内网或本地 HTTP 接口失败？

A：Vercel 体验版绑定的 .dev 域名因安全策略要求接口必须为 HTTPS，请使用 GitHub Pages 版本或自行部署，或开启 API 代理。

Q：如何更新到新版本？

A：使用 latest 标签时重新拉取镜像并重启即可，如 docker compose pull && docker compose up -d；需固定版本可用 0.2.x 等版本号标签。

Q：部署端预设的 API 地址会被用户改掉吗？

A：未开启锁定限制时，API 地址、模型等参数会与上次部署快照比较，部署值变化时覆盖一次本地值，之后保留用户修改；API Key 始终由用户本地管理。

Q：开启 API 代理有什么风险？

A：开启后任何人都可能把你的服务器当作代理请求目标 API，建议仅在具备访问控制（如 IP 白名单）或本地网络环境中开启。

注意事项

旧版环境变量 API_URL 已拆分为 DEFAULT_API_URL 和 API_PROXY_URL，容器启动时自动兼容，但建议尽早迁移。
DEFAULT_API_URL 指向 JSON 文件或容器内路径时，宿主机文件需通过 volume 挂载，容器启动时会读取并内嵌到页面。
预置配置提供三种写法：直接填 API 地址、API 地址加查询参数、JSON 文件路径或导入链接，末尾带 / 时直接拼接接口不补 /v1。
LOCK_PRESET_CONFIG_PARAMS 与 PREVENT_PRESET_CONFIG_DELETION 等限制项可按需组合使用，未开启时预置配置可拖动和删除。

核心亮点

内置 gpt-image-2 完整调用示例，降低 API 接入门槛
支持图片编辑和局部修改，交互直观易上手
基于 React + Vite，代码现代，易于二次开发

不足之处

依赖 OpenAI API 密钥，无法离线使用
文档/社区待观察

适用场景

快速原型验证 GPT 图像生成效果
作为教学示例学习 OpenAI 图像 API 集成
内部工具用于批量生成和编辑图片

替代项目

OpenAI Cookbook、LangChain、Stable Diffusion WebUI

项目介绍

gpt_image_playground 是图像领域的开源项目，由 CookSleep 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,767）位列前 30%，在图像分类的 839 个项目里位列前 7%。

近 42 天，它的 GitHub 星标从 3,404 增加到 3,767，净增 363。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：快速原型验证GPT图像生成效果。同类可对比的替代方案包括 OpenAI Cookbook、LangChain、Stable Diffusion WebUI。

上一篇：GPT-Image2-Skill

下一篇：takumi