跳到主要内容

图像生成

🎨 图像生成故障排除​

通用问题​

  • 图像无法生成（点击生成按钮无反应，或在对话中显示错误提示）：
    • 检查 Admin Panel（管理员面板） > Settings（设置） > Images（图像） 中的 Images 设置。确保 "Image Generation" 已开启（ON）。
    • 验证您的 API Key 和 Base URL（适用于 OpenAI、ComfyUI、Automatic1111）是否正确。
    • 确保所选模型已在您的后端服务中加载并可用（例如，检查 ComfyUI 或 Automatic1111 控制台以查看其活动状态）。
    • Azure OpenAI：如果看到 [ERROR: azure-openai error: Unknown parameter: 'response_format'.]，请确保您使用的 API 版本是 2025-04-01-preview 或更高版本。

ComfyUI 问题​

  • 不兼容的工作流 / JSON 错误（上传工作流后显示 Invalid workflow 或 JSON 解析错误）：

    • 需要 API 格式：Open WebUI 要求工作流必须是 API 格式。
    • 在 ComfyUI 中：
      1. 点击 "Settings"（齿轮图标）。
      2. 启用 "Enable Dev mode Options"（启用开发者模式选项）。
      3. 在菜单中点击 "Save (API Format)"（保存 (API 格式)）。
    • 请勿使用标准的 "Save" 按钮或标准的 JSON 导出。

  • 图像编辑 / 图像变体生成失败（根据文本生成能正常工作，但编辑或图生图（Image-to-Image）静默失败）：

    • 如果您正在使用图像编辑或图生图功能，您的自定义工作流必须配置了能够接收输入图像的节点（通常是一个被有效替换/关联的 LoadImage 节点）。
    • 检查 Open WebUI 设置中的默认“图像编辑”工作流，了解兼容所需的节点结构。

Automatic1111 问题​

  • 连接被拒绝 / "Api Not Found"（Automatic1111 正在运行，但 Open WebUI 报告连接错误）：

    • 确保您在运行 Automatic1111 时，在命令行参数中启用了 --api 标志。

  • Docker 连通性（Open WebUI 无法通过 localhost 访问 Automatic1111）：

    • 如果 Open WebUI 运行在 Docker 中，而 Automatic1111 运行在您的宿主机上：
      • 将 Base URL 设置为 http://host.docker.internal:7860。
      • 确保 host.docker.internal 是可解析的（在您的 Docker 运行命令中通过 --add-host=host.docker.internal:host-gateway 添加）。

环境变量与配置​

针对高级配置，您可以设置以下环境变量。

通用图像生成​

  • ENABLE_IMAGE_GENERATION：设置为 true 以启用图像生成。
  • IMAGE_GENERATION_ENGINE：要使用的引擎（例如 openai、comfyui、automatic1111、gemini）。
  • IMAGE_GENERATION_MODEL：用于生成的模型 ID。
  • IMAGE_SIZE：默认的图像尺寸（例如 512x512）。

特定引擎配置​

OpenAI / 兼容引擎

  • IMAGES_OPENAI_API_BASE_URL：兼容 OpenAI 的图像生成 API 的基础 URL。
  • IMAGES_OPENAI_API_KEY：图像生成服务的 API Key。

ComfyUI

  • COMFYUI_BASE_URL：您的 ComfyUI 实例的基础 URL。
  • COMFYUI_API_KEY：API Key（如果启用了身份验证）。
  • COMFYUI_WORKFLOW：自定义工作流 JSON（必须为 API 格式）。

Automatic1111

  • AUTOMATIC1111_BASE_URL：您的 Automatic1111 实例的基础 URL。
  • AUTOMATIC1111_API_AUTH：身份验证凭据（用户名:密码）。

Gemini

提示

有关完整的环境变量列表和详细的配置选项，请参考环境变量配置指南。

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.