跳到主要内容

图片生成

Elftia 的图片生成功能让你通过文本描述（提示词）使用 AI 生成图片，支持多种提供商、批量生成、参数自定义和速率限制下的自动重试。

使用场景​

  • 根据文字描述生成概念设计、插画或艺术作品
  • 在聊天中快速生成配图或参考图
  • 批量生成多张图片并挑选最满意的结果
  • 使用不同风格和参数对同一提示词进行多次尝试

支持的提供商​

提供商模型示例说明
GeminiGemini VisionGoogle 的多模态图片生成
OpenAIDALL-E 3、DALL-E 2、gpt-image-1OpenAI 的图片生成 API
Vertex AIImagenGoogle Cloud 的图片生成服务
自定义提供商自定义兼容 OpenAI 格式的第三方服务

配置提供商​

操作步骤​

  1. 打开 设置 > 媒体提供商 > 图片
  2. 从列表中选择一个提供商（例如 OpenAI）
  3. 输入该提供商的 API Key
  4. （可选）修改 API 端点地址（自定义提供商或代理时需要）
  5. 选择默认模型
  6. 点击 保存

提供商配置表​

配置项说明是否必填
API Key提供商的 API 密钥是
API 端点自定义 API 地址（默认使用官方地址）否
默认模型生成时默认使用的模型否
启用状态是否启用此提供商是

生成图片​

操作步骤​

  1. 在聊天界面或媒体生成界面中，选择图片生成功能
  2. 选择要使用的提供商和模型
  3. 在提示词输入框中输入图片描述
  4. 配置生成参数（见下方参数表）
  5. 点击 生成 按钮
  6. 等待生成完成，预览结果

生成参数​

参数说明可选值 / 范围
提示词 (Prompt)描述想要生成的图片内容任意文本
尺寸 (Size)生成图片的分辨率取决于模型，如 1024x1024、1792x1024 等
数量 (Count)一次生成的图片数量1-10（取决于提供商限制）
风格 (Style)图片风格vivid（生动）、natural（自然）等
质量 (Quality)图片质量standard、hd 等

:::tip 提示词技巧 好的提示词应该包含以下要素：

  • 主体：描述图片的主要内容
  • 风格：期望的艺术风格（写实、水彩、动漫等）
  • 细节：光照、构图、色调等细节描述
  • 否定提示：不希望出现的元素（部分提供商支持） :::

批量生成​

Elftia 支持带并发控制的批量图片生成，在需要生成多张图片时不会因为过多并发请求导致 API 限制。

行为说明​

  • 当生成数量大于 1 时，系统自动按并发限制分批发送请求
  • 默认并发数为 3，可在全局设置中调整
  • 每张图片独立生成，部分失败不影响其他图片

自动重试​

当遇到 API 速率限制（HTTP 429 错误）或其他临时错误时，系统会自动重试：

行为说明
重试次数默认 2 次，可在全局设置中调整
重试间隔指数退避策略：第一次 1 秒，第二次 2 秒，依次翻倍
速率限制处理检测到 429 错误时使用更长的退避时间，并添加随机抖动

结果管理​

生成的图片会：

  1. 在聊天消息中直接展示
  2. 自动保存到本地文件系统
  3. 记录在生成历史中，方便后续查看

操作选项​

  • 保存 — 将图片保存到指定目录
  • 复制 — 将图片复制到剪贴板
  • 收藏 — 将图片添加到收藏集
  • 重新生成 — 使用相同参数再次生成

添加自定义提供商​

如果你使用的图片生成 API 兼容 OpenAI 格式，可以添加为自定义提供商：

  1. 打开 设置 > 媒体提供商 > 图片
  2. 点击 添加自定义提供商
  3. 填写以下信息：
字段说明
名称提供商显示名称
API 端点API 基础地址
API Key认证密钥
模型列表可用模型的 ID 列表
  1. 保存后即可在生成时选择该提供商

常见问题​

问题解决方案
生成请求返回 401 错误API Key 无效或已过期，请检查并更新
生成请求返回 429 错误达到 API 速率限制，系统会自动重试；也可稍后再试
图片尺寸选项不全不同模型支持的尺寸不同，请确认所选模型的支持列表
自定义提供商无法使用确认 API 端点格式正确，且 API 兼容 OpenAI 图片生成格式
批量生成部分失败检查 API 配额是否充足，单个失败不影响其他图片

相关链接​