入门指南

Agent 生图：让 AI 客户端直接生成和编辑图片

配置一次生图 Skill，之后只要告诉 AI“生图”或“编辑这张图”，它就能通过 Yomi API 完成图片创作。

它能做什么

Agent 生图 Skill 让支持 Skill 的 AI 客户端直接调用 Yomi API 的图片生成与编辑接口。配置完成后，你可以用自然语言描述想要的画面，也可以提供已有图片让 AI 按要求修改。

文生图：根据文字描述生成图片，适合海报、插画、产品视觉和创意草图。
图片编辑：在已有图片的基础上修改内容、风格、构图或细节。
自然语言调用：直接说“生图”“生成图片”“画图”或“创建图片”，无需手动拼接 API 请求。

创建生图专用 API Key

登录 Yomi API 控制台，进入顶部导航的「秘钥管理」。
创建一个单独用于生图的 API Key，分组选择「GPT image专用（仅生图）」，并复制完整密钥。
为这个密钥设置仅满足生图所需的模型权限，避免把日常密钥散落在不同工具中。

完整密钥通常只在创建时显示一次，请复制并妥善保存。不要把真实密钥发布到公开聊天、代码仓库或前端页面中。

把提示词发给 AI

把下面的 sk-XXXXX 替换为你的生图专用密钥，再将整段提示词发送给你信任的私密 AI 客户端。AI 会安装完整 Skill、写入项目配置并验证调用，不需要你提前编辑 .env。

帮我配置并启用 Yomi API 的生图 Skill。

请先读取以下安装说明，并完成完整 Skill 的安装和配置：
https://yomiapi.com/skill/image-gen/INSTALL.md

这是我专门用于生图的 API Key：sk-XXXXX（替换为你另外创建的生图专用密钥）

请将密钥写入当前项目的 .env 文件，变量名为 YOMI_API_KEY，并确保 .env 已被 .gitignore 忽略。保留 .env 中已有的其他配置，不要在回复、日志、命令参数或 Skill 文件中回显密钥。

安装完成后，使用默认模型 gpt-image-2.5-sunburst 生成一张测试图，验证调用和图片保存是否正常。以后我提出“生图”“生成图片”“画图”“创建图片”或图片编辑需求时，默认使用这个 Skill 和 Sunburst，按照 Skill 的规则尊重我指定的型号、张数和预算，并使用这个生图专用密钥。

密钥会留在发送它的聊天记录中，请仅在可信的私密会话中使用。若不想在聊天中提供密钥，可自行在本地 .env 配置 YOMI_API_KEY，再将提示词中的密钥一行改为“我已在当前项目的 .env 中配置 YOMI_API_KEY，请直接读取使用”。

安装验证会生成一张 Sunburst 测试图，当前文档标价为 $0.025，最新价格以模型广场为准，用于确认调用和图片保存正常。

直接生图

Skill 配置完成后，直接向 AI 描述画面即可。例如：

生图：一张干净明亮的科技产品宣传图，画面中有一台银色笔记本电脑，留出右侧文字区域，横向构图。

如果需要编辑已有图片，可以说明要保留和修改的内容，例如“把背景换成深色渐变，保留主体和文字位置”。Skill 会根据客户端支持的方式提交图片生成或编辑请求。

三个模型和价格

gpt-image-2.5：1K 日常档，$0.013/张，适合日常配图、创意草图和成本优先的任务。
gpt-image-2.5-flare：4K 快速档，$0.02/张，注重生成速度，适合快速预览与迭代。
gpt-image-2.5-sunburst：4K 质量档，$0.025/张，注重画面质量与精细编辑，适合最终成品。

日常配图、草图、高清成品和图片编辑均默认使用 Sunburst，无需补充“高清”或“质量优先”。明确速度优先或高清任务要省钱时使用 Flare；未要求高清且明确要最便宜时使用 Image 2.5。AI 会按用途选画布，脚本默认尺寸仍为 1024x1024；修改时沿用已有要求。指定型号、张数和预算优先，一次需求默认只调用一款、生成一张。实际可用性与最新价格以控制台模型广场为准。

尺寸与高清档

4K 输出：Flare 和 Sunburst 均可请求横图 3840x2160 或竖图 2160x3840，选择型号后还需明确设置尺寸。
尺寸可能被调整：模型会按支持的尺寸生成图片，实际输出可能与请求尺寸不同。
核对实际像素：下载后用图片查看器或图像库读取文件尺寸。响应 JSON 的 size 可能缺失，实际像素以下载的图片文件为准。

需要固定画布比例时，在提示词中说明横向、竖向或正方形构图；图片编辑后也应核对实际尺寸。

速度与图片保存

Flare 注重速度，Sunburst 注重质量，实际耗时会受提示词、图片处理和网络状况影响。请求较慢时请等待完整响应，不要因为短时间没有返回就重复提交。

响应可能返回 url 或 b64_json。URL 可能约 24 小时有效，具体以响应为准；收到后立即下载，或将 base64 解码保存，不要把临时 URL 当作永久图片地址。

API 调用示例

如果需要手动检查请求格式，可以使用 OpenAI 兼容的图片生成接口：

curl https://api.yomiapi.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "一张干净明亮的科技产品宣传图，横向构图",
    "size": "1024x1024"
  }'

收到 JSON 后，立即下载其中的图片 URL，或将 b64_json 解码保存。生产环境请将密钥放在环境变量中，不要硬编码在脚本或日志里。