RoseKhlifa/Image-Studio

Image Studio – 用于 AI 图像生成的跨平台桌面客户端

它是什么

• 一个免费、开源的 GUI 应用程序，让您可以与任何兼容 OpenAI 的图像生成服务（例如 DALL-E、Stable Diffusion API、自定义托管模型）进行对话。
• 它专注于 Responses API 模式，通过 Server-Sent Events (SSE) 或 WebSocket 流式传输结果，帮助您避免长时图像生成时常见的 Cloudflare/Nginx 超时错误（HTTP 524/504）。
• 当上游仅提供传统端点时，支持标准 Images API (/v1/images/generations 和 /v1/images/edits) 作为备援。

为什么它很重要

• 许多托管图像生成后端位于反向代理之后，这些代理会切断长时间运行的请求。Image Studio 的流式模式可保持连接活跃并显示部分进度，使大型或高分辨率生成更加可靠。
• 它整合了 UI、配置和轻量级 Android WebView 包装器，因此您可以在 Windows、macOS、Linux 和 Android 上执行相同的客户端，而无需单独的代码库。

主要功能（如 README 中所述）

功能	您获得的内容
跨平台 UI	使用 Wails (Go + React/TypeScript) 构建。在桌面操作系统上原生执行，并作为 Android WebView shell 执行。
流式响应	为 Responses API 选择 HTTP SSE 或 WebSocket，这可减轻长推理期间的 524/504 断线问题。
标准 Images API 兼容性	可与任何公开 /v1/images/* 端点（生成、编辑等）的服务配合使用。
提示词导入助手	伴随项目 Image-Prompts 可以从网页抓取提示词并直接推送到 Image Studio。
批量 img2img	用于批量图像到图像处理的专用 UI（请参阅 docs/batch-img2img）。
自定义长宽比	通过“自定义比例”对话框保存常用的宽度 × 高度比例。
详尽文档	安装、配置、故障排除、性能测试和从源代码构建的指南。
开源授权	AGPL-v3 – 任何重新分发或作为服务提供的修改版本也必须开源。

如何开始

1. 下载 GitHub Releases 页面上的预编译二进制文件（或最新的 CI 成品以获取最新变更）。
2. 执行应用程序并开启 Upstream Configuration 画面。
3. 输入您的 API 详细信息 – 基础 URL、API 密钥以及您想要调用的模型 ID。
4. 选择您需要的 API 模式：
   • Responses API 用于长时间运行的作业（建议用于高质量或大型图像）。
   • Images API 如果服务仅实现了传统端点。
5. 填写提示词，调整大小、质量、输出格式和样式。您也可以添加自定义比例。
6. 按下 Generate（或 Ctrl/Cmd + Enter）。UI 将流式显示进度，并在准备好时显示最终图像。

故障排除工作流程（摘自 README）

• 使用内置的 Test Connection 按钮来验证基础 URL、密钥和模型 ID 是否可达。
• 在 History 视图中检查原始 HTTP 响应和状态码；许多失败是由于上游限制、权限错误或代理超时，而非客户端本身。
• 如果相同的凭证在 curl/Postman 中失败，请在提交问题之前联系上游提供者。
• 文档包含常见错误代码（401/403、524/504、model-not-found 等）的详细检查清单。

技术堆栈

• 后端: Go ≥ 1.25，使用 Wails v2 框架将 Web UI 嵌入为原生窗口。
• 前端: React 18 + TypeScript，编译为 Wails 二进制文件。
• 传输: HTTP SSE 或 WebSocket 用于流式传输；Images API 回退到普通 HTTP。
• 平台: Windows, macOS, Linux, Android（通过轻量级 WebView 包装器）。

谁会使用它

• 想要为任何兼容 OpenAI 的图像模型提供桌面 UI 而无需编写代码的艺术家和设计师。
• 测试自托管扩散服务器且需要能够承受代理超时的可靠客户端的开发人员。
• 需要批量 img2img 工作流程和提示词导入快捷键的高级用户。

哪里可以找到更多信息

• 完整文档位于 docs/ 文件夹下（安装、使用、故障排除、性能、构建说明等）。
• 伴随的 Image-Prompts 网站 (https://prompts.sorry.ink/) 展示了如何直接导入提示词。
• 问题、功能请求和社区讨论在仓库的 GitHub Issues 和链接的 QQ 群组中进行追踪。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。