文生图功能配置
This content is not available in your language yet.
文档版本：v1.0
最后更新：2026-06-11
适用范围：文本生图、AI 图片打印、ASR 热词、文生图记录排查
配置文生图前，先完成：
推荐按以下顺序配置：
AI管理 -> AI图像引擎：添加实际图像生成引擎。AI管理 -> LLM模型管理：添加提示词审核、优化、翻译使用的 LLM。AI管理 -> 文生图业务：创建文生图业务并配置提示词、NSFW、运行参数。设备管理 -> 设备型号管理 -> 功能配置：为型号绑定文本生图和标签打印热词(ASR)。设备管理 -> 设备管理 -> 设备详情 -> 扩展配置：配置设备语言、文生图业务等设备级覆盖项。AI管理 -> 文生图记录、打印管理 -> 打印任务、ASR记录：查看生成、打印和语音链路记录。
AI 图像引擎
Section titled “AI 图像引擎”进入 AI管理 -> AI图像引擎，新增或编辑图像引擎。
| 字段 | 说明 |
|---|---|
| 编码 | 引擎唯一编码，业务配置引用时使用 |
| 名称 | 后台展示名称 |
| 引擎类型 | 决定后端调用适配器，例如 Doubao、OpenRouter、SwarmUI、第三方图片引擎 |
| 平台地址 | 图像引擎 API Base URL |
| 鉴权用户名 | 部分平台需要的账号或用户名，没有可留空 |
| 鉴权密钥 | API Key、Token 或 Secret，必须脱敏保存和截图 |
| 最小宽高 / 最大宽高 | 限制业务可提交的图片尺寸范围 |
| 推荐分辨率 | 页面可选的尺寸档位，便于业务选择设备支持的输出大小 |
| 配置 | 引擎特有运行配置，例如超时、模型、额外请求参数 |
LLM 模型管理
Section titled “LLM 模型管理”进入 AI管理 -> LLM模型管理，添加用于提示词审核、提示词优化、提示词翻译或文本生成标签的模型配置。
| 字段 | 说明 |
|---|---|
| 配置名称 | 后台展示名称 |
| 协议类型 | 选择 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Claude Code、DeepSeek、千问等兼容协议 |
| Base URL | LLM 服务 API 地址 |
| API Key | 模型服务密钥，必须脱敏 |
| 模型列表 | 当前配置可调用的模型名称列表 |
| 默认模型 | 业务没有单独指定时使用的模型 |
| 超时时间 | 单次调用等待时间，避免提示词处理长期阻塞 |
| JSON 输出策略 | 文生图审核、优化、翻译需要模型输出可解析 JSON，建议开启或在提示词中强约束 |
LLM 会用于：
- 审核用户输入提示词是否合规。
- 将用户输入翻译为图像生成模型更容易理解的提示词。
- 优化用户提示词，补齐风格、构图、主体等描述。
- 文本生成标签等相关 AI 能力。
进入 AI管理 -> 文生图业务，创建文生图业务并配置业务版本。
| 配置 | 说明 |
|---|---|
| AI 图像引擎 | 选择实际执行图片生成的引擎 |
| LLM 模型配置 | 选择审核、优化、翻译等步骤使用的 LLM |
| NSFW 阈值 | 图片或提示词审核阈值，值越严格越容易拦截风险内容 |
| 开启按钮功能 | 控制是否启用审核、翻译、优化、图片审核等流程 |
| 提示词内容 | 配置审核、翻译、优化、生成时的系统提示词或模板 |
| 运行参数 | 传给图像引擎的模型、尺寸、步数、种子、风格、采样器等参数 |
| 服务器算法 | 后端对图片做缩放、压缩、裁剪、二值化、适配打印宽高等处理策略 |
提示词审核建议要求 LLM 输出稳定 JSON，例如是否通过、风险分类、原因、改写后的提示词等字段，避免后端无法解析。
型号功能配置
Section titled “型号功能配置”在 设备管理 -> 设备型号管理 中选择型号，点击 功能配置。
建议配置：
| 功能 | 配置 |
|---|---|
| 文本生图 | 选择已创建并启用的文生图业务 |
| 标签打印热词(ASR) | 选择热词类型、ASR 服务类型、ASR 模型名称 |
| 文本生成标签 | 按实际业务选择标签生成配置 |
型号配置是默认配置。单台设备需要不同语言或不同文生图业务时，可在设备详情扩展配置中覆盖。
设备详情扩展配置
Section titled “设备详情扩展配置”进入 设备管理 -> 设备管理 -> 设备详情 -> 扩展配置，按设备维护：
| 配置 | 用途 |
|---|---|
| 设备语言 | 影响 ASR 语言、提示词处理和设备参数下发 |
| 文生图业务 | 覆盖型号默认文生图业务 |
| 默认标签 | 覆盖型号默认标签，影响图片生成默认宽高 |
| 其他扩展参数 | 随 device_params 下发给设备，用于设备侧行为调整 |
设备拉取 device_params 时，云端会返回语言、时区、热词、功能配置等参数。
进入 AI管理 -> 文生图记录，可查看设备提交的文生图记录。重点关注：
- 设备 SN、型号、租户、用户。
- 原始提示词、优化后提示词、翻译后提示词。
- 使用的图像引擎、LLM 模型、业务版本。
- NSFW 分数与审核结果。
- 生成状态、失败原因、耗时。
- 输出图片与最终下发打印资源。
进入 打印管理 -> 打印任务，可以查看文生图产生的打印任务状态，也可以手动下发图片或 PRN 文件。
图片打印时需要确认：
| 配置 | 说明 |
|---|---|
| 图片宽高 | 需要压缩或缩放到设备支持范围 |
| 图片算法 | 控制灰度、二值化、抖动、裁剪、等比缩放等处理方式 |
| 文件大小限制 | 受设备型号的打印文件大小限制影响 |
| 任务有效期 | 超过有效期后设备不应继续打印 |
PRN 文件打印时，平台通常不再做图片算法处理，需确保 PRN 指令与设备协议兼容。
ASR 记录
Section titled “ASR 记录”进入 ASR记录 查看设备提交的语音记录。可用于排查：
- 设备是否成功上传语音。
- ASR 服务类型、模型、语言是否正确。
- 热词是否命中。
- 识别文本是否进入文本生图或文本生成标签流程。
- 失败原因是鉴权、网络、模型、音频格式还是业务处理。
- 设备在线并可正常 Pull 任务。
- 设备语音或文本触发文生图。
ASR记录能看到语音识别记录。文生图记录能看到提示词处理、图片生成和审核结果。打印任务能看到图片或 PRN 下发状态。- 设备成功打印，并上报打印回执。