跳到主要内容

OpenAI

注意

本教程由社区贡献，不受 Open WebUI 团队支持。它仅作为如何针对特定用例自定义 Open WebUI 的演示。想要贡献？请查看贡献教程。

Open WebUI 还支持通过 OpenAI API 进行图像生成。该选项包含一个选择器，可在 DALL·E 2、DALL·E 3 和 GPT-Image-1 之间进行选择，每个模型均支持不同的图像尺寸。

初始设置​

  1. 从 OpenAI 获取 API key。

配置 Open WebUI​

  1. 在 Open WebUI 中，导航至 Admin Panel > Settings > Images 菜单。
  2. 将 Image Generation Engine 字段设置为 Open AI。
  3. 输入您的 OpenAI API key。
  4. 选择您希望使用的模型。请注意，图像尺寸选项取决于所选的模型：
    • DALL·E 2：支持 256x256、512x512 或 1024x1024 尺寸的图像。
    • DALL·E 3：支持 1024x1024、1792x1024 或 1024x1792 尺寸的图像。
    • GPT-Image-1：支持 auto、1024x1024、1536x1024 或 1024x1536 尺寸 of 图像。

在 Open AI 处于选中状态，且 API key、模型和图像尺寸字段均已高亮显示的 Open WebUI 图像设置页面截图。

Azure OpenAI​

支持使用 Azure OpenAI（DALL·E 或 GPT-Image）进行图像生成。请按照以下步骤配置图像生成：

  1. 在 Open WebUI 中，导航至 Admin Panel > Settings > Images 菜单。
  2. 将 Image Generation Engine 字段设置为 Open AI（Azure OpenAI 使用与 OpenAI 相同的语法）。
  3. 将 API 端点 URL 更改为 https://<instance-id>.cognitiveservices.azure.com/openai/deployments/<model>/。将实例和模型 ID 设置为您在 Azure AI Foundry 设置中找到的对应值。
  4. 将 API 版本配置为在 Azure AI Foundry 设置中找到的对应值。
  5. 输入您的 Azure OpenAI API key。

在 Open AI 处于选中状态，且 API 端点 URL、API 版本和 API key 字段均已高亮显示以进行 Azure OpenAI 配置的 Open WebUI 图像设置页面截图。

Azure GPT-Image-1.5 配置

对于 Azure OpenAI gpt-image-1.5，请使用以下设置以确保成功生成图像：

  • 模型 (Model)：gpt-image-1.5
  • 图像尺寸 (Image Size)：1024x1024
  • API 版本 (API Version)：2025-04-01-preview
  • API 端点 URL (API Endpoint URL)：https://<your-resource-name>.openai.azure.com/openai/deployments/<your-deployment-name>/（确保包含末尾的斜杠）

如果您遇到错误 [ERROR: azure-openai error: Unknown parameter: 'response_format'.]，请仔细检查您的 API 版本是否已设置为 2025-04-01-preview 或更高版本。

提示

备用 API 端点 URL 教程：https://<endpoint name>.openai.azure.com/openai/deployments/<model name>/ —— 您可以在 https://ai.azure.com/resource/overview 找到您的端点名称，在 https://ai.azure.com/resource/deployments 找到模型名称。

您也可以从部署详情页面复制“目标 URI” (Target URI)，但请记得删除模型名称后面的字符串。

例如，如果您的目标 URI 是 https://test.openai.azure.com/openai/deployments/gpt-image-1/images/generations?api-version=2025-04-01-preview，那么 Open WebUI 中的 API 端点 URL 应为 https://test.openai.azure.com/openai/deployments/gpt-image-1/。

带有 OpenAI 端点的 LiteLLM 代理​

支持在 Open WebUI 中使用通过 OpenAI 端点的 LiteLLM 代理进行图像生成。请按照以下步骤配置图像生成：

  1. 在 Open WebUI 中，导航至 Admin Panel > Settings > Images 菜单。
  2. 将 Image Generation Engine 字段设置为 Open AI。
  3. 将 API 端点 URL 更改为 https://<your-litellm-url>:<port>/v1。
  4. 输入您的 LiteLLM API key。
  5. API 版本可以留空。
  6. 输入 LiteLLM 配置中显示的图像模型名称。
  7. 将图像尺寸设置为所选模型可用的尺寸之一。
提示

要查找您的 LiteLLM 连接信息，请导航至 Admin Panel > Settings > Connections 菜单。

您的连接信息将列在 OpenAI API 连接下方。

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.