给美术人员的 CPA 生图指南

把画面想清楚，
把需求说具体。

不必先研究参数。从风格、主体、细节和效果四个部分写提示词，再用参考图一点点调整，让每次生成都有明确方向。

先学提示词技巧组合我的提示词

已经会写？直接看后面的使用参考。还没装好工具？查看安装说明。

01 / 学写法

用四个部分，把需求讲完整

先选一个主风格、一个核心主体，再补充你最在意的细节。质量词最好对应能检查的画面效果。

[风格定位]＋[主体描述]＋[细节补充]＋[质量/技术词]

风格定位

想要什么画风？

国产仙侠、赛博朋克、写实、卡通、像素风。先确定一个主方向，避免把互相冲突的风格堆在一起。

例如：国产仙侠，偏写实的游戏美术风格。

主体描述

画什么，用在哪里？

人物、物品或场景。加上用途，帮助确定表现重点：背包图标、角色立绘、关卡气氛图。

例如：一枚白玉护符，用作游戏背包图标。

细节补充

哪些细节最重要？

材质、颜色、光影、构图和角度。挑三四项最重要的要求，先把大方向做好。

例如：青金绳结，柔和侧光，主体居中，深色背景。

质量/技术词

怎样才算达到要求？

高品质、精致、3D 渲染、游戏 UI 风格。再补上可检查的效果，例如清晰轮廓、材质分明、预留标题区域。

例如：精致 3D 渲染，缩小后仍能看清护符轮廓。

连起来，就是一条完整的美术需求

国产仙侠，偏写实的游戏美术风格。一枚白玉护符，用作游戏背包图标。青金色绳结，柔和侧光，主体居中且完整，深色纯背景。精致 3D 渲染，轮廓清晰，缩小后仍易辨认。

先写重要的

主体、用途、主风格优先。小装饰可以等第一张结果出来再加。

留白要说位置

活动图需要放标题，就写“中央上方留白”，不要只写“构图好看”。

排除项要具体

把“不要文字、不要外框”直接写进提示词，避免一长串与需求无关的限制。

02 / 动手写

试着组合你自己的提示词

选一份示例，把四个部分改成你的需求。这里只整理文字；复制到 Codex 对话里，才会开始生成图片。

从哪一类需求开始？

切换示例会替换下方内容；有需要保留的文字时，先复制。

风格定位确定主画风，例如仙侠、写实、卡通、像素风。主体描述写明画什么，以及这张图的用途。细节补充挑选最重要的材质、颜色、光影、构图或角度。质量/技术词把“高品质”补充成能够检查的要求。我会附上一张参考图

03 / 学修改

第一张图之后，怎样越改越接近？

把选中的结果作为参考图，先写要保留的内容，再写本次修改。一次集中改一类问题，更容易判断有没有变好。

沿用风格

做同一套资产

明确参考的是配色、材质还是描边，不要只说“做一张差不多的”。

$cpa-imagegen 参考我附上的图标，沿用配色、材质、描边粗细和光照方向，设计同系列的盾牌。主体换成盾牌，背景处理保持一致，另存为新图片。

修改细节

保留好的，只改问题

描述可检查的变化。人物面部、手部和小部件在改图后都要重新检查。

$cpa-imagegen 修改我附上的角色图。保留脸部、姿势、服装结构和背景，只把斗篷从红色改成深青色，其他部分尽量保持一致。保留原图，另存新版本。

比较方案

每次只比较一个变量

例如先比较三种配色，选定后再改材质，避免所有条件同时变化。

$cpa-imagegen 以我附上的药水瓶为参考，依次做金色、绿色、紫色三种液体配色。瓶型、视角、背景和光照保持一致，只调整液体颜色。分别保存成三个新文件，返回路径供我比较。

结果不满意，把反馈变成修改指令

看到的问题	可以这样说
“画面太乱”	保留主体，减少背景装饰，降低背景对比，让主体更突出。
“看起来很廉价”	减弱过曝高光，区分金属与皮革的质感，减少不必要的发光效果。
“跟原图不像”	保留原图轮廓、比例、视角和光照，本次仅修改指定配色。
“做成图标看不清”	放大核心主体，简化小装饰，提高主体与背景的明暗对比。

检查主体是否完整检查用途和构图检查保留项有没有变缩到使用尺寸再看

这些描述帮助明确修改目标，但不保证每次都能完全保留细节。挑选结果、检查和继续迭代仍然很重要。

使用参考：按场景套用提示词

示例路径以当前项目为起点，可按需要修改。

从零创作 / 技能与道具01

小尺寸也清楚的游戏图标

适合技能栏、背包道具和装备缩略图。

$cpa-imagegen 生成一枚“霜羽护盾”技能图标：银蓝色羽翼环抱一颗冰晶，方形构图，主体居中且完整，深蓝纯色背景，冷色手绘游戏风格。轮廓清楚，缩小后仍能看出羽翼与冰晶。不要文字、数字和水印。保存到当前项目的 art/icons/frost-shield-v1.png，完成后返回文件路径。

从零创作 / 角色设定02

把角色气质具体化

适合立绘方向探索、服装和材质设计。

$cpa-imagegen 为幻想冒险游戏设计一位“山谷信使”：短发青年，苔绿色防雨斗篷，皮革邮包，手持木制登山杖。全身三分之二侧面站姿，人物完整入画，浅灰纯色背景，细腻的手绘概念设定风格，突出布料、皮革与木材的区别。不要文字和水印。保存到当前项目的 art/characters/courier-v1.png。

从零创作 / 场景与宣传03

有层次的关卡气氛图

适合场景提案、活动背景和视觉方向讨论。

$cpa-imagegen 绘制一张横向关卡气氛图：雨后的山间驿站，近处是潮湿石阶，中景有挂着暖灯的木屋，远景是云雾中的吊桥。保持清晰的前中后景，中央偏左留出角色行动区域，温暖灯光与清冷环境形成对比，手绘冒险游戏风格。画布采用 1536x1024，左右延展构图，不要人物、UI 或文字。保存到当前项目的 art/scenes/mountain-stop-v1.png。

参考图 / 系列风格04

沿用已有美术风格

先附上参考图，再明确保留与新增的内容。

$cpa-imagegen 参考我附上的装备图，沿用它的配色、材质、描边粗细和光照方向，设计一面同系列盾牌。保持原图的方形构图与背景处理，盾牌完整入画，装饰纹样改为叶片主题。不要复制原来的武器轮廓，不加文字。保存到当前项目的 art/equipment/leaf-shield-v1.png。

局部调整 / 改色与迭代05

只改需要变化的部分

适合换装、调色和构图微调；生成后检查保留项。

$cpa-imagegen 修改我附上的角色图：保留脸部特征、发型、姿势、服装结构和背景，把斗篷从红色改成深青色，把金属扣件改成银色，其他部分尽量保持一致。另存到当前项目的 art/characters/hero-teal-v2.png，保留原图。完成后打开新图，重点检查面部和手部是否发生意外变化。

多方案 / 一次比较一个变量06

做三种配色，选定方向

按张依次生成，用不同文件名保存。

$cpa-imagegen 以我附上的药水瓶图为参考，依次生成三张配色方案：A 琥珀金，B 翡翠绿，C 紫罗兰。三张都保留瓶型、视角、背景、材质和光照，只调整液体颜色及对应微光。分别保存到当前项目的 art/variants/potion-a.png、potion-b.png、potion-c.png。每张生成完成后确认文件存在，最后返回三个路径供我比较。

工具还没装好？查看安装与使用步骤

01 / 安装

装好 Codex 与生图 Skill

前往 Codex 教程运行完整一键安装，按提示输入自己的 CPA API Key。安装器会一起安装 cpa-imagegen。

完整激活会重写 config.toml 和 auth.json；已有自定义配置请先备份。

打开一键安装教程 →

02 / 开始会话

进入你的项目

在项目目录打开终端，运行 codex，新建会话。提示词以 $cpa-imagegen 开头；需要改图时附上参考图或本地完整路径。

03 / 生成与确认

说清要什么、存在哪

复制下方示例并替换主体和路径。生成后先确认文件，再让 Codex 打开图片检查；后续修改另存为新版本。

使用已有 CPA Key，无需另配第三方生图账号。参考图和提示词会随生图请求提交到 CPA。安装模板的 Provider 为 dal_ai，不需要为生图切换聊天模型。

当前使用 Codex CLI 的 cpa-imagegen Skill。只运行 App 激活器或“只更新 CLI”不会补装此 Skill；Claude / Cline 的 MCP 接入不在本页提供。

需要指定尺寸或用命令调用？查看进阶说明

项目	本站当前用法
图片尺寸	脚本默认 `1024x1024`。在提示词中说明方形、横向或竖向构图；需要指定像素尺寸时使用 `--size`，以工具实际反馈为准。
参考图	支持一张或多张参考图；终端调用每张图使用一个 `--image`。输入图片需要存在于本机。
输出格式	使用 `.png`、`.jpg` / `.jpeg` 或 `.webp` 文件名。需要透明背景时明确提出要求，并选 PNG 或 WebP。
多张方案	一次调用保存一张结果。多方案依次生成并使用不同文件名；同名文件默认拒绝覆盖，不会自动加编号。
等待与重试	默认请求超时为 5 分钟。出现超时或中断后，先检查目标文件是否已生成，再决定是否重试。

直接用 PowerShell 调用生图脚本

以下命令适用于默认安装路径。先将输出位置替换为自己的项目目录；配置使用自定义 CODEX_HOME 时，脚本路径也应改为对应目录。

node "$HOME\.codex\skills\cpa-imagegen\scripts\cpa-imagegen.mjs" generate `
  --prompt "一枚银蓝色冰晶护盾图标，方形构图，深蓝背景，轮廓清楚，无文字" `
  --size "1024x1024" `
  --output "D:\GameArt\icons\frost-shield-v1.png"

node "$HOME\.codex\skills\cpa-imagegen\scripts\cpa-imagegen.mjs" edit `
  --image "D:\GameArt\source\hero.png" `
  --prompt "保留面部、姿势和背景，将斗篷改成深青色" `
  --output "D:\GameArt\output\hero-teal-v2.png"

脚本从当前 Provider 配置读取 CPA 地址，从本地 auth.json 读取 Key。无需把 Key 填入这些命令。只有明确需要覆盖原图时才添加 --force。

遇到问题，从这里检查

找不到 $cpa-imagegen，或没有生图入口？

运行 Codex 完整一键安装，确认用户目录中存在 .codex/skills/cpa-imagegen/SKILL.md，然后新建 Codex 会话。“只更新 CLI”只更新程序，不安装或修复 Skill。

提示 Key、Provider 或权限错误？

确认已经完成 CPA 激活，当前配置中 model_provider = "dal_ai" 对应 [model_providers.dal_ai]。如果 Key 无效或无图片权限，请联系管理员核对。不要把完整 Key 贴进聊天截图。

等待很久、超时或网络断开？

先检查指定路径有没有完整图片文件。文件存在时先打开确认，避免重复生成；尚未生成时，可稍后重试，并记录出错时间和错误信息供排查。

结果不符合预期，下一步怎么改？

把结果作为参考图，明确提出两三项可检查的修改，例如“保留轮廓、减弱高光、增大主体”。如果要做系列资产，固定同一张风格参考图，分别检查色彩、光照和边缘处理。

可以把参考文章的 MCP 配置直接填进来吗？

参考文章介绍的是另一套服务。本页使用 CPA 自有的 cpa-imagegen Skill；其 MCP 包名、Key 变量和参数不能直接当作本站配置使用。