跳到主要内容

OpenAI

注意

本教程为社区贡献内容，不属于 OPL 数据空间团队的官方支持范围。它主要演示如何按你的具体场景定制 OPL 数据空间。若想参与贡献，请查看贡献指南。

OPL 数据空间也支持通过 OpenAI API 生成图片。该方式支持在 DALL·E 2、DALL·E 3 和 GPT-Image-1 之间选择，并根据模型提供不同图像尺寸。

提示

在启用了 organizations 的部署中，图像设置可以按所选 admin organization 分别生效。如果某个 tenant 需要不同的 key 或模型，请先切换到目标组织再修改 Images 设置。

初始设置​

  1. 从 OpenAI 获取 API key。

配置 OPL 数据空间​

  1. 在 OPL 数据空间中进入 管理员面板 > 设置 > 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

Screenshot of the OPL 数据空间 Images settings page with Open AI selected and the API key, model, and image size fields highlighted.

Azure OpenAI​

OPL 数据空间同样支持通过 Azure OpenAI 使用 DALL·E 或 GPT-Image。配置方式如下：

  1. 在 OPL 数据空间中进入 管理员面板 > 设置 > Images。
  2. 将 Image Generation Engine 设置为 Open AI（Azure OpenAI 使用同样的语法）。
  3. 将 API endpoint URL 改为 https://<instance-id>.cognitiveservices.azure.com/openai/deployments/<model>/。其中实例名和模型 ID 可在 Azure AI Foundry 中查看。
  4. 将 API version 设置为 Azure AI Foundry 中显示的版本值。
  5. 填入 Azure OpenAI API Key。

Screenshot of the OPL 数据空间 Images settings page with Open AI selected and the API endpoint URL, API version, and API key fields highlighted for Azure OpenAI configuration.

Azure GPT-Image-1.5 配置

如果你要在 Azure OpenAI 中使用 gpt-image-1.5，建议采用以下配置：

  • Model: gpt-image-1.5
  • Image Size: 1024x1024
  • API Version: 2025-04-01-preview
  • API Endpoint URL: https://<your-resource-name>.openai.azure.com/openai/deployments/<your-deployment-name>/
    请确保 URL 末尾带有斜杠。

如果遇到 [ERROR: azure-openai error: Unknown parameter: 'response_format'.]，通常需要确认 API Version 至少为 2025-04-01-preview。

提示

另一种 API endpoint URL 形式是：https://<endpoint name>.openai.azure.com/openai/deployments/<model name>/。
你可以在 https://ai.azure.com/resource/overview 找到 endpoint name，在 https://ai.azure.com/resource/deployments 找到 model name。

也可以直接从部署详情页复制 Target URI，但记得删除 model name 之后的查询参数。
例如 Target URI 为 https://test.openai.azure.com/openai/deployments/gpt-image-1/images/generations?api-version=2025-04-01-preview，那么 OPL 数据空间中应填写的 API endpoint URL 是 https://test.openai.azure.com/openai/deployments/gpt-image-1/。

通过 LiteLLM 代理 OpenAI 端点​

OPL 数据空间支持通过 LiteLLM 代理 OpenAI 图像端点。配置方式如下：

  1. 在 OPL 数据空间中进入 管理员面板 > 设置 > Images。
  2. 将 Image Generation Engine 设置为 Open AI。
  3. 将 API endpoint URL 改为 https://<your-litellm-url>:<port>/v1。
  4. 填入 LiteLLM API Key。
  5. API version 可留空。
  6. 填写与你 LiteLLM 配置中一致的图像模型名。
  7. 将图像尺寸设置为该模型支持的范围之一。
提示

如需查看 LiteLLM 的连接信息，请进入 管理员面板 > 设置 > Connections。
OpenAI API 连接会显示在该页面中。