用途:通过 Retro Diffusion API 生成真正的像素画(整数像素网格、有限调色板),用于 2D 游戏精灵、图块集和动画,而非把扩散模型输出降采样成像素。属于付费服务,需在 https://www.retrodiffusion.ai 注册账号、购买积分并生成 API Key,每次调用从余额扣费。
主要能力:提供 generate(文生像素画)、img2img(参考图细化)、animate(行走、待机、攻击等动画,输出透明 GIF 或精灵表)、tileset(含 wang-tile 自动拼接图块)、edit(渐进式修改)、balance(查询余额)六种模式。模型有 RD_FAST、RD_PLUS、RD_PRO、RD_MINI,价格与尺寸各异,例如 RD_FAST 约 $0.015–0.04,RD_PRO 固定 $0.18。
使用方式:通过零依赖 Node 脚本 scripts/retrodiffusion-generate.mjs 调用,例如: RETRODIFFUSION_API_KEY=<key> node scripts/retrodiffusion-generate.mjs --mode generate --prompt "a cute green slime with big eyes" --model RD_FAST --style retro --width 64 --height 64 --output public/assets/sprites/ --slug slime 密钥可存于 .env,用 set -a; . .env; set +a 导出。认证头为 X-RD-Token,不是 Authorization: Bearer。输出为普通 PNG,可直接用于 Phaser 加载;建议在 Phaser 配置中设置 pixelArt: true 与 roundPixels: true 以保持像素锐利。每个输出旁会写 .meta.json 记录提示词、模型、风格、成本等。
适用场景:快速原型批量生成精灵、为已有游戏做美术润色、生成图块集与角色动画。
限制:不适用于 3D 模型、3D 世界或音频;需付费账号与积分;提示词应单一主体、明确视角与轮廓,避免抽象概念与视角冲突;批量生成时建议固定 --seed 并先用 --check-cost 估算成本。