使用 Auteo 生成图像
使用 auteo CLI(npm i -g @auteo/cli,然后 auteo auth login)。如果命令退出码为 3,请先按照 auteo-account 技能进行登录。MCP 用户可以使用末尾列出的 auteo_* 工具完成相同操作。
1. 选择模型
auteo model list --type text_to_image --json # 或使用 --type image_to_image 进行编辑
auteo model get <model> --json # 每个参数、选项和约束
生成前务必阅读 model get:不同模型的宽高比和分辨率层级有所不同,resolutionsByAspectRatio 会说明每个宽高比允许哪些层级。
粗略指南(以实际列表为准,列表会变化):
| 需求 | 推荐首选模型 |
|---|---|
| 最佳整体质量,图像中包含文字 | openai/gpt-image-2-6-sunburst,google/nano-banana-pro |
| 快速、便宜的草稿 | google/nano-banana,alibaba/z-image |
| 使用参考图像编辑照片 | google/nano-banana-2,bytedance/seedream-5-5 |
| Plus / Ultra 订阅用户免费 | 带有 subscriberUnlimited: true 的模型(例如 alibaba/z-image) |
2. 选择参数
--aspect-ratio为必填项。使用用户要求的宽高比;否则,头像和图标使用1:1,横幅和缩略图使用16:9,故事使用9:16,肖像使用3:4。某些模型也支持auto。- 当模型有多个层级(
1K/2K/4K)时,--resolution为必填项。层级越高,费用越高。草稿默认使用1K;仅在用户需要打印或大屏显示时才使用更高层级,并告知用户成本更高。 --n(1–4)可生成多个变体,每个变体单独收费。--image <路径|https-url>(可重复)用于添加参考图像以进行编辑或风格迁移。本地文件会上传;允许的数量请查看model get(inputAssetIds.max)。- 除非用户需要图像中渲染其他语言的文字,否则请使用英文编写提示词。
3. 检查价格,然后生成
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "a red fox in fresh snow, cinematic light" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <目录> 会等待结果并下载文件;JSON 输出中包含 files 和 outputs[].url。如果不使用 --out/--wait,命令会立即返回一个 requestId;稍后可使用 auteo generate wait <requestId> --out ./images 获取结果。
告知用户文件路径和消耗的积分(cost)。
失败情况处理
- 退出码 4,积分不足:停止操作并按照 auteo-account 技能处理(告知用户价格和余额,并提供充值链接)。不要自行降低设置。
- 退出码 2,参数无效:重新读取
auteo model get <model>并修正宽高比/层级组合。 - 退出码 5,提示词被内容审核拒绝:重写提示词,去除被标记的内容;重复发送相同的提示词会再次失败。
- 退出码 6,达到限制:正在进行的生成过多或提交过于频繁;等待后重试。
create命令超时或网络错误:不要盲目重新提交。运行auteo generate list --type image --limit 5 --json;如果请求不存在,使用--client-request-id <之前打印的 ID>重试,以避免重复收费。- 结果中出现
status: failed:报告errorMessage;如果设置了suggestedModel,请将其提供给用户。
MCP 工具
auteo_list_models,auteo_get_model,auteo_estimate_cost,auteo_upload_image(返回用于 inputAssetIds 的 assetId),auteo_generate_image,auteo_get_generation(在 pollAfterMs 之后再次调用,直至 done),auteo_list_generations。