企业官网建设流程全解析

商汤日日新 SenseNova U1.5 Lite 使用教程：文生图与图片编辑 API 调用方法

SenseNova U1.5 Lite 图片创作模型使用教程：文生图接口与图片编辑接口的完整调用方法及避坑说明

关键词

SenseNova U1.5 Lite、sensenova-u1.5-lite、商汤日日新、文生图 API、图片编辑接口、AI 绘图 API 调用、图生图教程、Base64 图片上传

摘要

SenseNova U1.5 Lite（model ID:sensenova-u1.5-lite）是商汤日日新基于 Neo-unify 架构的新一代图片创作模型。这篇文章介绍它的两个独立图像接口：/v1/images/generations文生图接口和/v1/images/edits图片编辑接口，包含完整 cURL 示例、请求参数表、响应结构，以及临时链接有效期、Base64 输入格式、watermark 参数等关键注意事项。

大家好 这里是「代码简单说」，这篇文章主要分享一下商汤日日新 SenseNova U1.5 Lite 图片创作模型的使用方法。

很多开发者在接入图像生成模型时，习惯性地去调 Chat Completions 接口，结果发现要么报错要么拿不到图片。SenseNova U1.5 Lite 不是这样用的，它走的是独立的图像接口，文生图和图片编辑各有一个端点。这篇文章会把两个接口的调用方法、参数和官方文档里明确标注的几个坑都讲清楚。适合需要在项目里接入 AI 绘图、图生图、图片改写能力的开发者。

一、SenseNova U1.5 Lite 是什么

SenseNova U1.5 Lite 是日日新最新一代图片创作模型，基于 Neo-unify 架构，生成与编辑一体，支持参考图功能及灵活修改。主要特点：

• 统一图像理解、生成与编辑链路，支持图片从创作到修改的完整流程
• 强化参考图创作与整体视觉表现，提升构图、光影、材质与细节的呈现
• 增强复杂指令遵循与多重约束执行能力，大幅提升复杂图文创作的准确与效果

model ID：sensenova-u1.5-lite

它提供两个独立图片接口：

• /v1/images/generations：文生图接口，仅输入文本 prompt 生成图片
• /v1/images/edits：图片编辑接口，输入参考图片 + 编辑提示词，完成图生图 / 图片改写

二、准备工作

调用前的准备事项：

• 一个 SenseNova 账号和有效的 API Key
• curl（Windows 10 以上系统自带，也可在 Git Bash 中执行）
• 图片编辑接口需要准备可公网访问的图片 URL，或本地图片的 Base64 Data-URL

鉴权方式与 SenseNova 其他接口一致，在 HTTP Header 中携带：

Authorization: Bearer $SENSENOVA_API_KEY

三、文生图接口使用方法

1. 先看三个官方警告

这一节的内容直接影响线上业务稳定性，建议先看完再写代码：

• U1.5 Lite 使用独立的图像生成接口，不是 Chat Completions 接口，不支持图像输入
• 接口返回的图片 URL 为临时访问链接，固定有效期 24 小时，超时后链接直接失效，无法再次访问图片
• 无水印生成（watermark=false）当前免费公测，后续将转为付费功能。为避免未来默认值变更影响线上业务，建议调用时显式传入watermark参数

2. 请求地址与 cURL 示例

POST https://token.sensenova.cn/v1/images/generations

curlhttps://token.sensenova.cn/v1/images/generations\-H"Authorization: Bearer$SENSENOVA_API_KEY"\-H"Content-Type: application/json"\-d'{ "model": "sensenova-u1.5-lite", "prompt": "一只海獭宝宝漂浮在平静海面上，柔和晨光，写实摄影风格", "n": 1, "size": "1024x1024", "output_format": "png", "response_format": "b64_json", "watermark": true }'# watermark=false：公测期间免费开放去水印

3. 请求参数表

4. 建议分辨率

size除auto外，官方建议的分辨率如下：

5. 响应结构

{"created":1713167890,"data":[{"url":"https://cdn.sensenova.dev/gen/..."}]}

如果response_format设置为b64_json，则data数组中返回的是b64_json字段而不是url。

四、图片编辑接口使用方法

图片编辑接口支持图生图和图片改写。该接口必须传入输入图片，不能仅传 prompt；为同步接口。

两个必须注意的输入限制：

• 此接口返回的response_format=url链接有效期同样为 24 小时
• 图片输入支持：公网 HTTP/HTTPS URL、Base64 Data-URL（data:image/png;base64,xxxx）；不支持纯无前缀 Base64 字符串

1. 请求地址

POST https://token.sensenova.cn/v1/images/edits

2. 请求示例

使用公网图片 URL 输入：

{"model":"sensenova-u1.5-lite","images":[{"image_url":"https://example.com/source.png"}],"prompt":"把背景改成雪山，人物保持不变","watermark":true,"prompt_extend":true,"size":"auto","response_format":"url"}

使用 Base64 Data-URL 输入：

{"model":"sensenova-u1.5-lite","images":[{"image_url":"data:image/png;base64,iVBORw0KGgoAAA..."}],"prompt":"将背景替换为纯白色","watermark":true}

完整 cURL 示例：

curlhttps://token.sensenova.cn/v1/images/edits\-H"Authorization: Bearer$SENSENOVA_API_KEY"\-H"Content-Type: application/json"\-d'{ "model": "sensenova-u1.5-lite", "images": [{"image_url":"https://example.com/source.png"}], "prompt": "把背景改成雪山，人物保持不变", "n": 1, "size": "2048x2048", "watermark": true, "prompt_extend": true, "response_format": "b64_json" }'

3. 请求参数表

五、常见问题

1. 返回的图片 URL 过几天打不开了怎么办？

这是正常现象。接口返回的图片 URL 是临时访问链接，固定有效期 24 小时，超时后链接直接失效。如果需要长期保存图片，拿到结果后应立即下载转存到自己的存储，或者直接使用response_format: "b64_json"拿 Base64 内容落盘。

2. 为什么用 Chat Completions 接口调不通？

U1.5 Lite 使用独立的图像生成接口，不是 Chat Completions 接口，且文生图接口不支持图像输入。文生图走/v1/images/generations，图片编辑走/v1/images/edits。

3. Base64 图片传入后请求被驳回？

图片输入只支持公网 HTTP/HTTPS URL 和带data:image/*;base64,前缀的 Base64 Data-URL，不支持纯无前缀的 Base64 字符串。本地图片需要拼成data:image/png;base64,xxxx这种完整格式再传入。另外链接访问失败、内容不是图片、Base64 解码错误都会直接驳回请求。

4. watermark 参数要不要传？

建议显式传入。无水印生成（watermark=false）当前免费公测，后续将转为付费功能，官方明确建议调用时显式传入watermark参数，避免未来默认值变更影响线上业务。

5. 一次能生成多张图吗？

不能。n参数仅支持值为1，无论文生图还是图片编辑接口都是如此。需要多张图时只能多次请求。

6. size 可以随便写吗？

不能随便写。宽和高必须是 32 的倍数，最小值 512，最大值 4096，最大比例 3:1 或 1:3。不确定时可以直接用auto（编辑接口自动适配主图），或使用官方建议的分辨率列表。

六、总结

以上就是 SenseNova U1.5 Lite 的完整使用教程。核心要点：model ID 为sensenova-u1.5-lite，文生图用POST https://token.sensenova.cn/v1/images/generations，图片编辑用POST https://token.sensenova.cn/v1/images/edits，编辑接口必须传输入图片，返回的图片 URL 只有 24 小时有效期，Base64 输入必须带 Data-URL 前缀，watermark建议显式传参。按照上面的步骤操作即可完成接入。如果遇到其他问题，可以结合具体报错信息进行排查。