前言¶

在 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