跳到主要内容

图片生成

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 配额是否充足,单个失败不影响其他图片

相关链接​