Manai 教程文档

Manai8 生图 Skill 使用教程

本章节介绍如何在 Codex 中安装并使用 Manai8 生图 Skill。按照步骤完成配置后， 你可以直接在 Codex 中通过自然语言生成图片，或基于已有图片进行修改。

一、适用场景

Manai8 生图 Skill 适合以下使用场景：

• 文生图：输入一段图片描述，生成一张新图片。
• 改图：上传或指定一张原图，并描述需要修改的内容。
• 海报与素材制作：生成产品图、宣传海报、头像、插画、封面等视觉素材。

该 Skill 默认使用 Manai8 图片接口：

实际请求会发送到：

https://api.manai8.xyz/v1/images/generations
https://api.manai8.xyz/v1/images/edits

二、下载 Skill 包

请先下载 Manai8 生图 Skill 包：

下载 Manai8 生图 Skill 安装包

下载后解压压缩包。解压后你会看到：

README_Manai8_Shengtu_Skill.md
shengtu-skill/

其中 shengtu-skill 文件夹才是真正需要安装到 Codex 的 Skill 文件夹。请复制整个文件夹，不要只复制里面的单个文件。

三、准备 API Key

使用前请准备一把可用于 Manai8 生图接口的 API Key。

请注意：

• API Key 是你的访问凭证，请勿发给他人。
• 不要把 API Key 写进公开文档、截图、聊天群或公开仓库。
• 如果怀疑 API Key 已泄露，请立即在 Manai 控制台删除旧 Key，并重新创建新的 Key。

四、安装到 Codex

将解压后的 shengtu-skill 文件夹复制到 Codex 的 skills 目录。

Windows 通常是：

C:\Users\你的用户名\.codex\skills\shengtu-skill

macOS 通常是：

/Users/你的用户名/.codex/skills/shengtu-skill

复制完成后，请重启 Codex，让 Codex 重新加载 Skill。

五、保存 Manai8 生图 API Key

打开终端，进入 shengtu-skill 文件夹。

Windows 示例：

cd C:\Users\你的用户名\.codex\skills\shengtu-skill
python scripts\generate_image.py --save-api-key "你的Manai8_API_KEY"

macOS 示例：

cd /Users/你的用户名/.codex/skills/shengtu-skill
python scripts/generate_image.py --save-api-key "你的Manai8_API_KEY"

看到类似下面的提示，即表示保存成功：

Saved image API key to ...

这个操作只会保存生图 Skill 自己使用的 Key，不会修改你的 OPENAI_API_KEY。

六、让 Codex 生成图片

安装并保存 API Key 后，可以直接在 Codex 中提出生图需求。

示例一：

用 shengtu-skill 生成一张图片：一只白色猫咪坐在窗边，阳光照进来，写实摄影风格，保存为 cat.png

示例二：

用 shengtu-skill 生成一张 1024x1024 的产品海报，主体是一瓶香水，干净背景，高级商业摄影风格，保存为 perfume.png

为了获得更稳定的效果，建议描述中包含：

• 主体：画面中最重要的对象。
• 背景：图片所在环境。
• 风格：写实、插画、海报、商业摄影等。
• 尺寸：例如 1024x1024。
• 文件名：例如 poster.png。

推荐模板：

用 shengtu-skill 生成一张 1024x1024 的图片：主体是【你要的东西】，背景是【背景】，风格是【写实/插画/海报/摄影】，画面干净清晰，保存为【文件名.png】

七、使用 Skill 修改图片

如需改图，请先准备一张原图，例如 input.png。

然后在 Codex 中说明要修改什么：

用 shengtu-skill 修改 input.png：保持主体不变，把背景换成干净的白色影棚背景，保存为 edited.png

也可以这样写：

用 shengtu-skill 修改 input.png：让图片更明亮、更清晰，人物不要变形，保存为 fixed.png

改图时建议明确说明哪些内容需要保留、哪些内容需要变化。例如“保持人物不变”“只替换背景”“不要改变商品外观”等。

八、常用尺寸

常用尺寸如下：

请使用 宽x高 的格式填写尺寸，例如 1024x1024。不建议只写 1K、2K 或 4K。

九、也可以直接用命令生成

如果你不想通过 Codex 对话，也可以在终端中直接运行脚本。

文生图示例：

python scripts/generate_image.py \
  --prompt "A clean product poster with clear subject and soft studio lighting" \
  --size 1024x1024 \
  --out poster.png

改图示例：

python scripts/generate_image.py \
  --mode edit \
  --prompt "Improve the lighting and keep the main subject unchanged" \
  --image input.png \
  --size 1024x1024 \
  --out edited.png

十、常见问题

提示 Missing image API key

说明还没有保存生图 API Key。请重新运行：

python scripts/generate_image.py --save-api-key "你的Manai8_API_KEY"

提示 HTTP 401

通常是 API Key 不正确、已过期、余额不足，或该 Key 没有生图权限。请检查 Key 是否复制完整，并确认账号状态正常。

提示输入图片不存在

请检查图片路径是否正确。如果你写的是：

input.png

那么这张图片必须真实存在于当前文件夹中。

图片生成时间较长

图片生成可能需要几十秒。高分辨率、复杂提示词、多人场景或精细商品图通常会更慢，请耐心等待。

如何查看 Key 保存位置

在 shengtu-skill 文件夹里运行：

python scripts/generate_image.py --show-config-path

如何删除已保存的 Key

在 shengtu-skill 文件夹里运行：

python scripts/generate_image.py --clear-api-key

十一、安全建议

• API Key 只应保存在自己的设备中。
• 不要将 API Key 发给他人或上传到公开平台。
• 生成商业素材前，请自行确认素材用途、版权要求和平台规则。
• 如果需要给多人使用，建议为不同人员创建不同的 API Key，便于后续管理和停用。