前言¶
在对话式开发环境里,用户一句「帮我出一张 16:9 封面」或「按这张参考图改风格」,Agent 若缺少明确指引,往往会去猜模型、猜比例,或误用视频、OCR 等非生成类能力。把调用规则写进 Skill,可以在触发词、参数结构和鉴权方式上对齐同一套约定。下面介绍社区 Skill image2-kancyai(坐标 @user_4bd21536/image2-kancyai,版本 1.0.1),它封装可想 AI 的 image2 异步任务接口,面向文生图(text2img)与参考生图(img2img)。
这是什么¶
image2-kancyai 是 SkillHub 上分类为 design-media 的社区 Skill,发布者为 user_4bd21536。一句话定位:当用户要生成图片、图生图、海报图、封面图,或明确给出画面比例(如 16:9、9:16)时,Agent 应通过本 Skill 调用 image2 的 asyncCreateWithCost 创建带计费信息的异步生成任务。
Skill 页标注 requires_api_key=true,需在 kexiangai.com 侧准备 x-api-key。官方说明同时写明:不要用于视频生成、OCR,以及非生成式的图片编辑。
核心功能¶
已核实能力均围绕接口 /api/v1/user_task/asyncCreateWithCost,核心入参落在 user_input 中:
| 字段 / 概念 | 说明 |
|---|---|
user_input.modelType |
text2img:文生图;img2img:参考生图 |
prompt |
生成描述 |
size |
画面尺寸(可与用户要求的 16:9、9:16 等比例对应) |
urls |
img2img 必填,参考图地址,最多 8 张 |
文生图只需 text2img 与 prompt、size;参考生图必须在 urls 中提供可访问的图片链接,否则不符合接口约定。
安装与启用¶
资料中未给出 Cursor、Codex CLI、Claude Code 各自的专用安装命令,此处只写可核对的路径与配置要点。
-
在 SkillHub 查看 Skill 说明与包内容:
https://www.skillhub.cn/skills/user_4bd21536/image2-kancyai -
按你所用 Agent 产品的 Skill 加载方式,将坐标
@user_4bd21536/image2-kancyai(或官方分发地址)加入工作区 Skill 列表。官方 API 入口:
https://api.skillhub.cn/user_4bd21536/image2-kancyai -
在环境或 Skill 要求的位置配置 x-api-key(来源:kexiangai.com)。未配置时,异步创建任务会因鉴权失败而无法进行。
典型用法¶
Skill 的职责是告诉 Agent:何时调用、调哪个路径、必填字段是什么。实际 HTTP 由 Agent 或配套脚本发起;下面用结构示例说明 user_input 应如何组织(字段名以官方简介为准)。
文生图(text2img)时,先选定 modelType,再写清 prompt 与 size:
{
"user_input": {
"modelType": "text2img",
"prompt": "扁平插画风格的产品海报,留白充足",
"size": "16:9"
}
}
参考生图(img2img)时,在同样字段基础上必须带上 urls,且不超过 8 张:
{
"user_input": {
"modelType": "img2img",
"prompt": "保持构图,换成夜景霓虹风格",
"size": "9:16",
"urls": [
"https://example.com/reference-1.png"
]
}
}
请求需携带 x-api-key 头,并 POST 到 /api/v1/user_task/asyncCreateWithCost。任务为异步创建;轮询或回调方式以可想 AI / image2 平台当前文档为准,本 Skill 简介未展开,文中不臆造响应字段。
用户话术与 Skill 触发条件的对应关系可以概括为:
- 「生成图片」「海报图」「封面图」→ 优先 text2img,除非用户明确给了参考图
- 「图生图」或附带图片 URL → img2img,且
urls必填 - 明确比例 → 写入
size(如 16:9、9:16)
适用场景与注意¶
适合谁
- 需要在 IDE / CLI Agent 里稳定产出封面、海报、配图,且希望与可想 AI image2 计费任务对齐的团队或个人。
- 希望用自然语言比例(16:9、9:16)驱动生成,而不是每次手写完整 API 文档的开发者。
限制与注意
- 边界:不用于视频、OCR、非生成式修图;超出范围应换其他 Skill 或工具。
- 鉴权:依赖 x-api-key,密钥勿提交到公开仓库;Skill 标签已标明
requires_api_key=true。 - 参考图数量:img2img 的
urls最多 8 张,超出需裁剪或分批任务。 - 社区来源:分类 design-media,来源为 community;SkillHub 页显示评分 100000、下载 882(统计以 SkillHub 页面为准,会随时间变化)。
结尾¶
image2-kancyai 把「什么时候画图」和「image2 异步任务最少要填哪些参数」写进 Agent 可读的 Skill,减少误触发和漏填 urls。若你的工作流里经常出现封面、海报或参考生图需求,可从 SkillHub 安装并配置 kexiangai 的 API Key,再让 Agent 在用户提到生成图片或比例时走 /api/v1/user_task/asyncCreateWithCost。