跳到主要内容

图像生成

🎨 图像生成排障​

通用问题​

  • 点了生成没结果 / 聊天里报错
    • 去 管理员面板 > 设置 > Images 确认 Image Generation 已开启
    • 在组织化部署里，确认当前选中的管理员组织就是你要配置的目标作用域
    • 检查 API key、Base URL 和模型名是否正确
    • 确认后端服务（ComfyUI、Automatic1111、OpenAI 兼容服务等）里模型确实可用
    • Azure OpenAI 如果报 Unknown parameter: 'response_format'，请确保 API 版本是 2025-04-01-preview 或更新

Qwen 相关问题​

  • 认证 / 权限错误

    • 确认 IMAGES_QWEN_API_KEY 或 IMAGES_EDIT_QWEN_API_KEY 有效
    • 确认默认 Base URL 是否为 https://dashscope.aliyuncs.com/api/v1
    • 如果生成正常但编辑失败，确认已经启用 Image Edit，并且 IMAGE_EDIT_ENGINE=qwen

  • 不同组织行为不一致

    • 检查当前组织是否有自己的 Images 设置覆盖
    • 从 管理员面板 显式切换 Global 与目标组织后重新测试
    • 对照 Qwen 配置指南 核对字段

ComfyUI 问题​

  • 工作流格式错误 / JSON 错误

    • OPL 数据空间要求上传的是 API Format 工作流
    • 在 ComfyUI 中启用开发者选项，然后使用 Save (API Format)
    • 不要使用普通的 Save 或普通 JSON 导出

  • 图像编辑 / image-to-image 失败

    • 自定义工作流必须能够接收输入图像
    • 最好对照 OPL 数据空间默认的“Image Editing”工作流结构逐项核查

Automatic1111 问题​

  • 连接被拒绝 / API 不存在

    • 启动 Automatic1111 时必须带 --api

  • Docker 里连不到宿主机

    • 如果 OPL 数据空间在 Docker，Automatic1111 在宿主机，通常要把 Base URL 改成 http://host.docker.internal:7860
    • 同时确认 host.docker.internal 可被解析

常用环境变量​

通用图像生成​

  • ENABLE_IMAGE_GENERATION
  • IMAGE_GENERATION_ENGINE
  • IMAGE_GENERATION_MODEL
  • IMAGE_SIZE

OpenAI / 兼容服务​

  • IMAGES_OPENAI_API_BASE_URL
  • IMAGES_OPENAI_API_KEY

ComfyUI​

  • COMFYUI_BASE_URL
  • COMFYUI_API_KEY
  • COMFYUI_WORKFLOW

Automatic1111​

  • AUTOMATIC1111_BASE_URL
  • AUTOMATIC1111_API_AUTH

Gemini​

Qwen​

  • IMAGES_QWEN_API_BASE_URL
  • IMAGES_QWEN_API_KEY
  • IMAGES_EDIT_QWEN_API_BASE_URL
  • IMAGES_EDIT_QWEN_API_KEY
  • Qwen 配置指南
提示

完整环境变量列表见 Environment Configuration。