Agent Skills
返回列表
CCG 异步生图

CCG 异步生图

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，帮我安装规范名为 @user_83b77f2d/ccg-image 的技能。

技能介绍

要解决的问题

CCG AI 是异步生图，手工完成时要分别处理提交任务、轮询状态、kind/b64_json 与 inlineData 两种返回、落盘和错误恢复。不同模型在尺寸、耗时、扩展名上还有差异，很容易把 .jpg 写死或重复提交导致重复计费。@user_83b77f2d/ccg-image 把这条链路压成一条命令：你只需给 prompt、sk- 开头的 CCG API Key 和可选参考图，脚本负责提交、轮询、解析、保存并打印路径。

核心能力与流程

脚本只用 Python 标准库。默认文生图走 gpt-image-2；传入参考图时自动切到 edit；指定 Gemini 模型时自动改用原生 inlineData；多张参考图重复 --image；历史任务可用 --job pj_xxx 直接查询保存。模型选择规则：精确尺寸、图标或 UI 素材用 gpt-image-2；参考图改主体用 gpt-image-2；复杂场景、写实或中文理解用 gemini-3-pro-image-preview；追求速度用 gemini-3.1-flash-image-preview。实测耗时约 5 秒 / 20 秒 / 60 秒以上，默认轮询超时 420 秒。

注意点

Key 优先用 CCG_API_KEY 环境变量传入，回复中只显示脱敏形式。Gemini 实测返回 image/png，应按 magic bytes 判断扩展名，不要硬编码 .jpg。Gemini 不接受 size：无参考图默认 2048x2048，有参考图跟随参考图尺寸；要精确尺寸仍用 gpt-image-2。edit 的参数在 fields 且 n 是字符串，generation 的参数在 body 且 n 是数字。遇到 401/403 先确认 Key；任务 failed 时查看后端错误原文；轮询超时后不要重提交，用 --job 取回。更多尺寸和接口细节见 references/api-reference.md。

使用场景

  • 手里有产品参考图，需要保留主体仅替换背景或修改风格，不想手动处理 edit 接口的字段差异。
  • 正在开发应用，需要批量生成严格符合指定宽高的图标和 UI 素材，确保排版时不溢出。
  • 提交了复杂写实场景的生图任务但轮询超时，需要用任务 ID 取回结果，避免重复提交计费。
  • 需要用中文提示词生成具有复杂光影和写实质感的插画，并希望脚本自动按真实格式保存。

适合人员

  • 独立开发者：需要在自己的后端服务中集成稳定的生图和改图能力，不想自己写异步轮询和错误重试逻辑。
  • UI 设计师：需要批量产出尺寸严格精准的图标和界面素材，希望用命令行一键生成并直接落盘到本地。
  • 内容运营：手里有大量带人物或产品的参考图，需要频繁替换背景或改变画风，同时严格要求不泄露 API Key。