前言¶
在 Cursor、Claude Code 等环境里做配图或改图,常见做法是手写脚本调各家图像 API,或在对话里反复粘贴 curl。接口字段、模型名和批量出图都要自己记。SkillHub 上的社区 Skill「图片制作」(@user_a0de7824/tupian)把文本生成图片(T2I)、图片编辑(I2I)、多图融合和批量生成封装成 Agent 可遵循的 SKILL 流程,并统一走 New API 与 Seedream 模型族。下面介绍它是什么、能做什么,以及如何安装与配置。
这是什么¶
「图片制作」是 SkillHub 分类 design-media 下的社区 Skill(来源:community,发布者 user_a0de7824,当前版本 1.0.0)。坐标为 @user_a0de7824/tupian,页面与元数据可通过 SkillHub 技能页 与 API 地址 https://api.skillhub.cn/user_a0de7824/tupian 查看。
它面向已在使用 Agent Skills 的开发者:在本地 skills 目录安装后,由 Agent 按 Skill 说明调用 New API,完成出图与改图,而不必每次从零拼请求。
核心功能¶
以下能力均来自官方 Skill 简介,已核对页面与抓取资料一致:
- 文本生成图片(T2I):根据文字描述生成图片。
- 图片编辑(I2I):在已有图片基础上按指令修改。
- 多图融合:将多张图片按任务要求融合处理。
- 批量生成多张图片:一次任务产出多张结果。
- Seedream 模型:支持所有 Seedream 模型(通过 New API 侧选择具体模型)。
Skill 带有 requires_api_key=true 标签,使用前必须配置 New API 访问密钥。
安装与启用¶
1、安装 SkillHub CLI(若尚未安装)¶
先检查是否已安装:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 官方安装文档执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明与路径差异见:SkillHub 安装与优先源配置。
2、安装「图片制作」到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认会装到 ./skills/,Agent 可能无法识别。
skillhub install user_a0de7824/tupian --dir <skills 目录>
常见客户端 skills 路径(摘自官方安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将下面说明交给 AI,让其按 skillhub.md 安装 @user_a0de7824/tupian(与 SkillHub 页面「将提示词发送给你的 AI 安装该 skills」一致)。
3、配置环境变量¶
| 变量 | 是否必需 | 说明 |
|---|---|---|
NEWAPI_API_KEY |
必需 | New API 访问密钥 |
BASE_URL |
可选 | 自定义 API 端点;默认 https://docs.newapi.pro/v1 |
在运行 Agent 或执行 Skill 相关命令的环境中导出上述变量,例如:
export NEWAPI_API_KEY="你的密钥"
# 可选:使用自建或代理端点
# export BASE_URL="https://docs.newapi.pro/v1"
安装或改配置后,按你所用客户端要求重启或重载 Agent,以便加载新 Skill。
典型用法¶
官方页面未单独给出可复制粘贴的 CLI 示例命令;可复现部分为:安装 Skill → 配置 NEWAPI_API_KEY(及可选 BASE_URL)→ 在对话中说明图像任务。
结合已公布能力,可按下列方式向 Agent 发起请求(表述可自定,需与 Skill 能力一致):
- T2I:说明画面主题、风格、尺寸或张数,并指明使用 Seedream 系列中某一模型(若你有指定)。
- I2I:提供待编辑图片路径或附件,并写清修改意图。
- 多图融合:提供多张输入图及融合目标(如合成场景、风格统一)。
- 批量生成:在同一提示中说明需要多张变体或一组主题图。
Agent 会依据已安装的 SKILL.md 流程调用 New API;具体 HTTP 路径与参数以 Skill 包内说明及 New API 文档为准。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills,希望统一用 New API + Seedream 做配图、改图、多图合成。
- 愿意自行申请并保管
NEWAPI_API_KEY,且能接受社区 Skill(user_a0de7824维护)的更新节奏。
限制与注意
- 无有效
NEWAPI_API_KEY时无法调用接口;请勿将密钥提交到仓库。 BASE_URL默认指向https://docs.newapi.pro/v1;若使用自定义网关,需与 New API 兼容。- 社区来源 Skill,安装前可在 SkillHub 页面查看版本与说明;抓取资料显示评分为 100000、下载约 21780 次(以平台实时数据为准)。
- 图像生成受模型策略、配额与内容审核约束,批量任务可能更耗配额与时间。
结尾¶
「图片制作」把 T2I、I2I、多图融合与批量出图收敛到一条 Agent Skill 路径,依赖 New API 与 Seedream 模型,配置集中在 NEWAPI_API_KEY 与可选 BASE_URL。若你正在 SkillHub 的 design-media 分类里找图像类能力,可从官方页安装 @user_a0de7824/tupian 试用。
- SkillHub 页面:https://www.skillhub.cn/skills/user_a0de7824/tupian
- API 元数据:https://api.skillhub.cn/user_a0de7824/tupian