AI 功能

兰空图床集成了 AI 能力，支持对图片进行智能润色、自动打标签、自动生成描述。系统支持多个 AI 供应商，管理员可以在后台创建和管理 AI 驱动，并通过角色组控制用户的 AI 使用权限和配额。

支持的供应商

供应商	图片润色	打标签	生成描述
OpenAI	✅	✅	✅
Google Gemini	✅	✅	✅
火山引擎（豆包）	✅	✅	✅
智谱 AI（GLM）	✅	✅	✅
阿里百炼（通义千问）	❌	✅	✅
月之暗面（Kimi）	❌	✅	✅

TIP

图片润色需要供应商支持图片生成能力，阿里百炼和月之暗面目前仅支持文本能力，因此不支持图片润色功能。

AI 能力说明

图片润色

通过自然语言描述，让 AI 对图片进行编辑和增强处理。例如：「将背景替换为蓝天白云」、「提高图片亮度和对比度」、「将图片转为水彩画风格」等。

用户提交润色任务时可以选择是否替换原图，如果不替换，系统会生成一张新图片。

自动打标签

AI 会自动分析图片内容，生成准确的描述性标签。系统支持自动识别中英文，并根据图片内容返回合适语言的标签。

自动生成描述

AI 会自动分析图片内容，为图片生成一段简洁的描述文字，该描述会保存在图片的简介字段中。

创建 AI 驱动

AI 功能的所有配置均在管理后台完成，无需手动修改配置文件。

进入管理后台，在左侧菜单找到「驱动」分组下的「AI 驱动」，点击「新建」来创建一个 AI 驱动。

创建驱动时需要填写以下信息：

• 名称：驱动名称，用于在前台展示给用户。
• 供应商：选择一个 AI 供应商，不同供应商支持的能力不同。
• 简介：可选，驱动的简要说明。
• API Key：供应商的 API 密钥。
• API 地址：可选，自定义 API 地址。留空将使用供应商的默认地址，输入框会以 placeholder 形式提示当前供应商的默认地址。适用于使用中转服务、代理或私有部署的场景。
• 能力：勾选该驱动需要开启的能力（图片润色、打标签、生成描述），不支持的能力将被禁止选择。

根据所选的供应商和能力，还需要配置对应的模型：

• 图片润色：需要填写图片模型 ID 和选择生成质量。系统会提供常用模型作为建议，你也可以直接输入任意模型 ID。
• 打标签 / 生成描述：需要填写文本模型 ID。同样支持从建议列表选择或手动输入。

自定义提示词

勾选「打标签」或「生成描述」能力后，表单底部会显示对应的提示词配置区域（默认折叠）。每个能力包含两项可配置的提示词：

• 系统指令：用于指导 AI 如何分析图片和输出结果的系统级指令。
• 用户提示词：发送给 AI 的具体请求内容。

所有提示词字段均为可选，留空时系统将使用内置的默认提示词（输入框的 placeholder 中展示了当前的默认内容）。当你需要针对特定场景调整 AI 的行为时，可以自定义提示词，例如：

• 要求 AI 始终返回中文标签
• 调整生成标签的数量范围
• 修改描述的长度或风格要求
• 添加特定领域的分析指引

TIP

模型字段支持自由输入，不限于预设列表。当供应商更新了新模型，或你使用的中转服务提供了自定义模型名称时，可以直接输入对应的模型 ID。

TIP

同一个供应商可以创建多个驱动，使用不同的 API Key、API 地址或模型配置，以满足不同场景的需求。例如，你可以为同一个供应商创建两个驱动，一个使用官方 API 地址，另一个使用中转服务地址。

各供应商默认 API 地址

以下是各供应商的默认 API 地址，仅在 AI 驱动未配置自定义 API 地址时使用：

供应商	默认 API 地址
OpenAI	https://api.openai.com/v1
Google Gemini	https://generativelanguage.googleapis.com/v1beta
火山引擎（豆包）	https://ark.cn-beijing.volces.com/api/v3
智谱 AI（GLM）	https://open.bigmodel.cn/api/paas/v4
阿里百炼（通义千问）	https://dashscope.aliyuncs.com/compatible-mode/v1
月之暗面（Kimi）	https://api.moonshot.cn/v1

TIP

火山引擎、智谱 AI、阿里百炼、月之暗面均使用 OpenAI 兼容协议，大多数 OpenAI 兼容的中转服务都可以配合这些供应商使用。

角色组配置

AI 功能通过角色组进行权限控制，管理员可以在编辑角色组时配置以下选项：

启用 AI

在角色组设置中开启「AI」开关后，该角色组下的所有用户即可使用 AI 功能。

关联 AI 驱动

与储存类似，每个角色组可以关联多个 AI 驱动。只有关联了 AI 驱动的角色组，其用户才能使用对应的 AI 能力。

使用频率限制

为了控制 AI 资源消耗，可以为角色组设置多个维度的使用频率限制：

限制维度	说明
每分钟限制	每分钟内允许使用的次数
每小时限制	每小时内允许使用的次数
每天限制	每天允许使用的次数
每周限制	每周允许使用的次数
每月限制	每月允许使用的次数

将任意限制值设为 0 表示该维度不限制。所有限制维度同时生效，任意一个维度达到上限即无法继续使用。

WARNING

AI 功能按次计费，每处理一张图片计为一次使用。批量提交时（如同时选择 10 张图片打标签），会一次性消耗对应的次数。

任务处理机制

AI 任务通过消息队列异步处理，提交任务后系统会立即返回任务状态，前端会自动轮询获取任务进度。

任务状态包括：

状态	说明
等待中	任务已提交，等待队列处理
处理中	任务正在被 AI 处理
已完成	任务处理成功
失败	任务处理失败，可查看错误信息

TIP

AI 功能依赖消息队列来异步处理任务。如果发现任务一直处于「等待中」状态，请检查消息队列是否已正确配置并正常运行。详见 安装 - 配置消息队列 章节。