前言¶

在 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），可与安装后的文件核对。

模型选型¶

旧 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