如何用一张照片制作自定义 Codex 宠物

什么是 Codex 宠物？

Codex 宠物是在你工作时出现在 Codex 里的动态小伙伴。它可以等待、奔跑、挥手、跳跃，也会在任务失败、工作和检查等环节呈现不同动作。

一个自定义宠物包通常包含描述宠物信息的 pet.json，以及保存全部动画帧的 spritesheet.webp。Codex 会结合这两个文件，在不同状态下显示对应动作。

Codex Pet Kit 是独立的兼容工具，不是 OpenAI 官方产品。它的作用是把生成结果整理成 Codex 自定义宠物可以使用的文件格式。

第一步：选择一张清晰的原图

画面里应该有一个明确主体，可以是人物、宠物、吉祥物、Logo 或物品。正面或接近正面、光线均匀的图片，更容易帮助系统保留轮廓和关键特征。

提前选出两三个最重要的辨识点。这次案例里的紫色心形发夹、白色毛衣、长发和剪刀手，让最终宠物仍然可以被一眼认出来。

尽量避开多人合照、严重模糊、大面积遮挡、极端拍摄角度和很小的印刷文字。这些细节很难在几十个动作帧中保持一致。

第二步：选择 Codex 宠物风格

像素宠物会把主体做成轮廓更鲜明的像素游戏精灵。动物、吉祥物、Logo，以及适合大胆简化的主体，通常很适合这种风格。

Q版宠物使用可爱的大头身、完整紧凑的身体、圆润的 2D 上色和更鲜明的表情动作，适合人物、宠物和二次元角色。

Founder Pet 的比例更柔和，会保留更多服装、发型和配件信息。人物肖像、创作者、创始人形象和私人礼物通常更适合它。

应该根据哪些特征必须被保留来选择风格，而不是只比较哪张静态预览更精细。像素宠物、Q版宠物和创始人宠物最终都会生成相同结构的可安装宠物包。

第三步：生成全部 9 种动作状态

上传原图、选择风格、输入有效生成码，然后开始生成。完整流程通常需要约 10–15 分钟，具体时间会受到模型响应速度和图片复杂度影响。

系统会生成 9 种状态、共 72 帧：待机、向右奔跑、向左奔跑、挥手、跳跃、失败、等待、工作和检查。

这些状态应该是独立动作，而不是把同一张静态图重复排列。四肢、表情、方向和姿势需要发生变化，同时保持角色身份一致。

第四步：检查并下载完整宠物包

生成完成后，检查透明预览和动作图。重点确认五官或轮廓仍有辨识度，服装和颜色基本一致，动作容易看懂，透明边缘没有明显问题。

离开结果页之前先下载 ZIP。宠物包会包含 pet.json、spritesheet.webp、preview.png、contact-sheet.png 和 README.md。

解压后应保持文件夹完整。随意改名或拆开 pet.json 与 spritesheet.webp，可能会导致 Codex 无法正确找到宠物。

• pet.json 定义宠物身份和 spritesheet 路径
• spritesheet.webp 保存完整动作图集
• preview.png 展示透明背景角色预览
• contact-sheet.png 用于检查全部动作
• README.md 提供安装说明

第五步：把自定义宠物安装到 Codex

先解压下载文件。在 Codex Settings 里打开 Pets，然后使用 Open folder 按钮进入正确的自定义宠物目录，不需要自己寻找隐藏文件夹。

把解压出来的整个宠物文件夹移动到该目录。pet.json 和 spritesheet.webp 应该直接位于宠物文件夹顶层，中间不要再多套一层文件夹。

回到 Codex，刷新自定义宠物列表并选择新宠物。如果没有出现，优先检查文件夹是否嵌套过多，以及必要文件有没有被改名。

常见错误与合理效果预期

AI 生成动画可能在手部、配件、边缘和细小服装纹理上出现轻微差异。好的结果应该保持辨识度并且可以使用，但不一定逐个细节完全复制原图。

如果原图触发模型安全审核，或者生成过程发生技术失败，系统会按照服务规则返还生成码。建议换成更清晰、更少敏感因素的原图后重新尝试。

不要只根据第一张预览判断结果。选图、风格、全部动作检查和正确文件夹结构，都是制作自定义 Codex 宠物的一部分。

• 选择单一清晰主体和均匀光线
• 让重要特征足够明显
• 检查全部 9 种状态的动作
• 关闭结果页之前下载 ZIP
• 移动完整文件夹，不要改名必要文件