跳转到主要内容
生成结果仅保存在当前浏览器本地不会自动存储在你的服务器或 AIOHub 服务器清空浏览器数据会删除历史图片,请及时下载需要保留的结果。
自行部署 GIP 适合需要自定义域名、内网访问、团队统一入口或访问控制的场景。推荐使用 Docker 部署:不需要改源码,升级和回滚也更直接。 GIP 是一个浏览器图片客户端。你仍然使用 AIOHub 的模型调用 API 和 API 令牌完成鉴权、计费和日志记录。
GIP 的上游项目是 CookSleep/gpt_image_playground。部署前请确认你信任自己的服务器环境,并为浏览器客户端使用独立 API 令牌。

推荐配置

配置项
默认 API 地址https://api.aiohub.org
API 令牌你的 AIOHub sk- API 令牌
API 接口Images API(/v1/images
模型 IDgpt-image-2
Codex CLIcodex* 分组开启;openai 分组关闭
Timeout360-600 秒

Docker 启动

在服务器上安装 Docker 后运行:
docker run -d \
  --name gip \
  --restart unless-stopped \
  -p 8080:80 \
  -e DEFAULT_API_URL=https://api.aiohub.org \
  ghcr.io/cooksleep/gpt_image_playground:latest
启动后访问:
http://你的服务器:8080
打开 GIP 设置,填入 AIOHub API 令牌,选择 Images API,模型填 gpt-image-2
DEFAULT_API_URL 只会预填 GIP 页面中的 API 地址。用户仍需要在页面中填写自己的 API 令牌。

Docker Compose

如果你用 Compose 管理服务,可以创建 docker-compose.yml
services:
  gip:
    image: ghcr.io/cooksleep/gpt_image_playground:latest
    container_name: gip
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      DEFAULT_API_URL: "https://api.aiohub.org"
启动:
docker compose up -d
查看日志:
docker logs -f gip
更新:
docker compose pull
docker compose up -d

可选:绑定域名

如果只是自己临时使用,可以直接访问 http://你的服务器:8080,不需要绑定域名。
如果要给多人或团队长期使用,可以考虑绑定 HTTPS 域名,并通过 Nginx、Caddy 或你的服务器面板反向代理到容器端口 8080。这样更便于分享固定入口,也可以在反向代理层增加登录、IP 白名单或内网访问限制。 Nginx 示例:
server {
    listen 443 ssl http2;
    server_name image.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
如果只给团队内部使用,建议至少在反向代理层增加登录、IP 白名单或内网访问限制。

可选:开启同源 API 代理

默认情况下,浏览器会直接请求 https://api.aiohub.org。一般不需要开启 GIP 的同源 API 代理。 只有在你明确需要由自己的服务器转发请求时,才添加这些环境变量:
services:
  gip:
    image: ghcr.io/cooksleep/gpt_image_playground:latest
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      DEFAULT_API_URL: "https://api.aiohub.org"
      ENABLE_API_PROXY: "true"
      API_PROXY_URL: "https://api.aiohub.org"
开启同源 API 代理后,任何能访问该站点的人都可能通过你的服务器转发请求。只在有登录、IP 白名单、内网隔离或其他访问控制的环境中开启。

后续使用

部署完成后,GIP 的客户端配置方式和网站内嵌版本一致。参考 网站内嵌 GPT Image Playground (GIP) 的配置方法,填写 AIOHub API 令牌、Images API、gpt-image-2Codex CLI 开关和超时时间。
如果开启同源 API 代理,仍需为自部署站点保留登录、IP 白名单、内网隔离或其他访问控制。