前言¶
在 IDE 或 CLI 里让 Agent 根据一句话出图，常见做法是手写 OpenAPI 片段、查文档对齐参数，再把 Token 和 curl 拼进对话。商汤日日新 SenseNova 的图片接口是同步 HTTP，参数多、默认值容易踩坑（例如默认返回 Base64 而不是 URL）。若你明确要用商汤 U1 系列做文生图或参考图编辑，更希望 Agent 按官方约定直接调 https://token.sensenova.cn/v1，而不是临时拼凑脚本。
下面介绍 SkillHub 社区 Skill sensenova-u1-image（坐标 @user_b3cc4a8b/sensenova-u1-image，当前版本 1.1.0，分类 design-media，标签 requires_api_key=true）。它把 SenseNova 图片生成与编辑的流程写进标准 SKILL.md，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载。
这是什么¶
sensenova-u1-image 是一份面向 Agent 的操作说明：通过 curl 调用商汤 SenseNova U1.5 模型族官方图片 API，完成文生图（POST /v1/images/generations）和图片编辑（POST /v1/images/edits，支持参考图）。维护方为 SkillHub 社区发布者 user_b3cc4a8b，来源标注为 community。
Skill 强调：U1 系列仅用于同步图片生成/编辑，不能当作对话模型走 /v1/chat/completions。Base URL 为 https://token.sensenova.cn/v1，更完整的平台说明见 SenseNova 文档。
当用户提到商汤、SenseNova、U1、U1.5、文生图、图生图、图片编辑、改图，或希望用该模型族从文字/参考图生成或修改图片时，Agent 应触发此 Skill。
核心功能¶
以下内容均来自 Skill 包内 SKILL.md（v1.1.0），可与安装后的文件核对。
模型选型¶
| 模型 | model_id | 用途 |
|---|---|---|
| U1.5 Fast（默认） | sensenova-u1.5-fast |
兼顾速度与质量，适合快速迭代 |
| U1.5 Lite | sensenova-u1.5-lite |
更高画质、复杂指令与参考图创作 |
旧 ID sensenova-u1-fast 在 Skill 记载的实测中仍可出图，但建议迁移到 sensenova-u1.5-*。
文生图¶
- 端点：
POST https://token.sensenova.cn/v1/images/generations - 必填：
model、prompt - 常用可选：
size（如2048x2048）、watermark、response_format、output_format、prompt_extend n仅支持1；要多张图需循环调用
图片编辑¶
- 端点：
POST https://token.sensenova.cn/v1/images/edits - 必填：
model、images（最多 5 张，首张为主图）、prompt - 参考图支持公网 URL 或带完整前缀的 Base64 Data URL（
data:image/png;base64,...）
Agent 侧 Token 管理¶
Skill 约定在 MEMORY.md 的「工具设置」中保存 sensenova-u1-image 的 token；首次需用户在 SenseNova 控制台 创建 API Key。请求头为 Authorization: Bearer {token}。
默认值与错误处理¶
Skill 明确要求显式传入 response_format（建议 url）和 watermark（无 Logo 时传 false），避免官方默认 b64_json 导致取不到 data[0].url。curl 示例含 --max-time 180、--retry 3；对 429、500 等可重试错误有退避说明，并附 HTTP 状态与 error.message 对照表。
安装与启用¶
SkillHub 页面给出的安装指引是：让 Agent 按 SkillHub 安装文档 安装 @user_b3cc4a8b/sensenova-u1-image。
若本机已安装 skillhub CLI，需把技能装到当前 Agent 识别的 skills 目录（文档要求使用 --dir，否则默认 ./skills/ 可能不被加载）。示例：
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install @user_b3cc4a8b/sensenova-u1-image --dir <skills 目录>
常见 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后重启或刷新 Agent，使 SKILL.md 被加载。本 Skill 依赖商汤 API Key，使用前需完成 Token 配置。
典型用法¶
1. 文生图（Fast，2K 方图）¶
先用控制台拿到的 Token 替换 YOUR_TOKEN。下面请求向生成接口提交 prompt，并显式指定 URL 返回格式与无水印。
curl -s --max-time 180 --retry 3 --retry-delay 5 \
https://token.sensenova.cn/v1/images/generations \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "sensenova-u1.5-fast",
"prompt": "你的图片描述",
"size": "2048x2048",
"n": 1,
"watermark": false,
"response_format": "url",
"output_format": "png"
}'
从响应 JSON 读取 data[0].url。Skill 说明该链接约 24 小时有效，应尽快下载：
curl -s -o output.png "<image_url>"
2. 参考图编辑（Lite）¶
用户提供公网可访问的原图 URL 时，可调用编辑接口：
curl -s https://token.sensenova.cn/v1/images/edits \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "sensenova-u1.5-lite",
"images": [{ "image_url": "https://example.com/photo.png" }],
"prompt": "将背景替换为雪景，保持主体人物不变",
"size": "auto",
"watermark": false,
"response_format": "url"
}'
本地文件需先转为带 data:image/png;base64, 前缀的 Data URL 再填入 image_url。
3. 在对话里触发¶
在已启用 Skill 的 Agent 中，用自然语言描述需求即可，例如「用商汤 U1 生成一张 16:9 的山间日出壁纸」或「按这张参考图把背景改成夜景」。Agent 应按 Skill 选择 size、模型 ID，并走上述 HTTP 流程而非聊天补全接口。
适用场景与注意¶
适合谁
- 已在商汤 SenseNova 开通 API、需要把文生图/改图固定进 Agent 工作流的设计、运营或开发者。
- 希望统一用 curl 同步调用、并遵守尺寸规则（宽高超 512–4096、32 的倍数、长宽比不超过 3:1）的团队。
限制与注意
- 必须自备 API Token；Skill 标签为
requires_api_key=true。 - 单次
n只能为 1；批量需循环，注意配额与 429。 - 默认
watermark=true会加官方 Logo；Skill 建议每次显式传watermark与response_format。 - 4K 与 Lite 耗时更长，Skill 实测 Fast 2048² 约十余秒量级，请保留足够超时。
- SkillHub 页面统计（抓取时）：评分 100000，下载 933；以 SkillHub 技能页 为准。
结尾¶
sensenova-u1-image 把商汤 SenseNova U1.5 的文生图与参考图编辑收敛成 Agent 可执行的 curl 流程：模型选型、参数显式化、Token 存放位置与错误重试都写在 SKILL.md 里，减少每次对话重新查文档的成本。
官方入口：
- Skill API 地址：https://api.skillhub.cn/user_b3cc4a8b/sensenova-u1-image
- SkillHub 展示页：https://www.skillhub.cn/skills/user_b3cc4a8b/sensenova-u1-image
