📦 Ernie Image Gen

ERNIE-Image Generation 通过兼容 OpenAI 的 API，使用百度 AI Studio 的 ERNIE-Image 模型生成图像。 提供两个模型： ERNIE-Image-Turbo（默认）：生成速度快，适合大多数场景 ERNIE-Image：质量更高，生成较慢，适合对细节要求高的场景 两个模型对中文提示词理解尤佳。

前置条件 Python 3.11+ 并已安装 uv 设置环境变量 AI_STUDIO_API_KEY 为你的百度 AI Studio 访问令牌 获取令牌：https://aistudio.baidu.com/account/accessToken

生成流程 步骤 1——编写提示 撰写描述性提示（≤1024 字符，约 150 词）。中英文皆可。明确主体、风格、构图与氛围。 好：“金色小狗坐在向日葵花田的日落中，温暖金光，浅景深，专业摄影” 坏：“狗”

步骤 2——选择参数 参数 | 可选值 | 默认值 model | ERNIE-Image-Turbo, ERNIE-Image | ERNIE-Image-Turbo size | 1024x1024, 768x1376, 1376x768, 896x1200, 1200x896, 848x1264, 1264x848 | 1024x1024 n | 1-4 | 1 seed | 任意整数 | 随机 steps | 4-20 | 8 guidance | 1.0-7.5 | 1.0 use-pe | 开/关 | 关

尺寸建议：人像海报选竖向（768x1376、848x1264、896x1200），风景封面选横向（1376x768、1264x848、1200x896），通用 1024x1024。

步骤 3——运行生成脚本 使用 uv 执行： uv run {baseDir}/scripts/generate.py "<提示>" --model ERNIE-Image-Turbo --size 1024x1024

批量生成： uv run {baseDir}/scripts/generate.py "<提示>" --n 4 --output ./output_dir

高质量模式： uv run {baseDir}/scripts/generate.py "<提示>" --model ERNIE-Image --steps 16 --guidance 3.5

可复现结果： uv run {baseDir}/scripts/generate.py "<提示>" --seed 42

步骤 4——输出 脚本将 PNG 图保存至输出目录并打印： Saved: ernie_20260430_110100.png (1.7 MB) MEDIA:/absolute/path/to/ernie_20260430_110100.png MEDIA: 行可在兼容环境自动贴图。

如需 JSON 输出，加 --json： { "success": true, "model": "ERNIE-Image-Turbo", "files": [{"path": "/abs/path/ernie_20260430_110100.png", "size_bytes": 1715660}], "prompt": "...", "parameters": {"size": "1024x1024", "seed": 42} }

快捷触发 当用户说出以下任意触发语，将其后内容视为提示并立即按默认参数生成： 中文：生成图片：xxx / 文生图：xxx / 百度生图：xxx / ERNIE生图：xxx 英文：generate image: xxx / ernie image: xxx / baidu image: xxx 默认：model=ERNIE-Image-Turbo, size=1024x1024, n=1, b64_json 格式。

注意事项 图像本地保存为 PNG，路径以 MEDIA: 开头便于自动贴图。 中文提示在 ERNIE 模型上效果尤佳。 提示增强（--use-pe）可把简短提示扩展为更丰富描述，短提示可开启，精确控制请关闭。 加 --quiet 可隐藏进度，仅输出 MEDIA: 行或 JSON，适合代理工作流。 完整 API 参考、模型对比、尺寸选项、参数详解与故障排查，请阅读 {baseDir}/references/api-guide.md。