qwen-sketch-to-image 的模型介绍
更新时间：2026-02-05 17:00:46
模型介绍
图片生成
通义万相-涂鸦作画通过手绘任意内容加文字描述，即可生成精美的涂鸦绘画作品，作品中的内容在参考手绘线条的同时，兼顾创意性和趣味性。涂鸦作画支持扁平插画、油画、二次元、3D卡通和水彩5种风格，可用于创意娱乐、辅助设计、儿童教学等场景。
模型效果演示
适用场景
- 创意贺卡设计：用户可以利用涂鸦作画功能，结合节日主题和个人创意，手稿创作一幅圣诞老人与驯鹿在雪地中的温馨场景，增加贺卡的个性化与情感表达，使收卡人感受到更加真挚与特别的祝福。
- 儿童绘本制作：教育工作者或家长可以根据孩子的兴趣和故事内容，涂鸦作画制作富有教育意义和趣味性的插图绘本，提升儿童阅读兴趣，促进想象力和创造力的发展。
- 个性化商品设计：电商平台或设计师可以利用该功能快速生成具有独特艺术风格的产品设计，如T恤、手机壳、马克杯上的涂鸦创作图案，满足消费者对个性化和定制化商品的需求。
- 社交媒体内容创作：博主和内容创作者可利用涂鸦作画创作与主题内容相符的原创涂鸦插图，提高内容的视觉吸引力，帮助建立独特的个人品牌形象，吸引并保持粉丝的关注。
- 室内装饰设计：室内设计师可以为客户定制个性化的墙面艺术画或装饰图案，如根据房间风格创作相应风格涂的鸦画作，实现空间的个性化定制，提升居住或办公环境的艺术氛围。
模型出入参
请求参数（标准调用入参）
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| messages | Array<{ role: "user"; content: Array<Text|ImageUrl> }> | 是 | - | 标准多模态消息；需包含一条 user 消息，含草图图片与文本提示 |
| messages.role | "user" | 是 | - | 仅支持 user |
| messages.content | Array<Text | ImageUrl> | 是 | - | 多模态内容数组：文本或图片 URL |
| contenttype=image_url | { type: "image_url"; image_url: { url: string } } | 是（至少一项） | - | 草图图片 URL（必填） |
| contenttype=text | { type: "text"; text: string } | 是（至少一项） | - | 文本提示词（生成说明） |
| parameters | WanxSketchToImageLiteParameters | 否 | 见下 | 模型参数对象 |
| parameters.size | "768768" | "7201280" | "1280*720" | string | 否 | "768*768" | 图片尺寸（宽*高） |
| parameters.n | number | 否 | 4 | 生成图片数量，范围 1-4 |
| parameters.sketch_weight | number | 否 | 10 | 草图权重，范围 0-10，数值越大越遵循草图 |
| parameters.style | string | 否 | " | 风格描述： <auto> /<3d cartoon> /<anime> /<oil painting> /<watercolor> /<sketch> /<chinese painting> /<flat illustration> 等 |
| parameters.sketch_extraction | boolean | 否 | false | 是否对输入图片进行边缘提取（开启后自动提取草图） |
| parameters.sketch_color | number[] | 否 | 画笔色数组（RGB 三元组），在 sketch_extraction=false 时生效 |
更多通用采样/控制参数见
../COMMON_PARAMS.md
。请求参数（直连 API 入参）
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| model | string | 是 | wanx-sketch-to-image-lite | 模型名称 |
| input | object | 是 | - | 输入对象 |
| input.sketch_image_url | string | 是 | - | 草图图片 URL（必填） |
| input.prompt | string | 是 | - | 文本提示词（生成说明） |
| parameters | WanxSketchToImageLiteParameters | 否 | 见上 | 参数同上（size、n、sketch_weight、style、sketch_extraction、sketch_color） |
响应参数（出参）
后端原始响应（核心字段，实际返回可能包含额外信息）：
字段名 | 字段类型 | 是否必传 | 字段默认值 | 字段说明 |
|---|---|---|---|---|
| request_id | string | 否 | - | 请求 ID |
| id | string | 否 | - | 响应 ID |
| object | string | 否 | "chat.completion" | 对象类型 |
| model | string | 否 | - | 使用的模型名 |
| created | number | 否 | - | 时间戳（秒） |
| code | number | 否 | 0 | 错误码 |
| error | string | 否 | "" | 错误信息 |
| usage | { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | 否 | - | Token 统计（如有） |
| output.task_id | string | 否 | - | 异步任务 ID |
| output.task_status | string | 否 | - | 异步任务状态 |
| output.results | Array | 否 | 结果集合（后续通过任务查询接口获取最终图片） |
标准化输出（SDK 适配后）说明：
- 该模型为异步非流式，SDK 返回 type = "async_task"的消息，content为包含task_id/task_status/results的 JSON 字符串，可配合任务查询接口获取图片结果。
使用示例
qwen-sketch-to-image 基础 Agent 调用示例
下面示例展示了如何通过自定义 Agent 接入
qwen-sketch-to-image
模型，实现涂鸦生图 / 草图转精细图像能力。javascript
async sendMessage(message) {
try {
// 需要有草图图片
if (!message?.files?.[0]?.url) {
return {
code: -1,
msg: '请上传草图图片'
};
}
const contentParts = [
{
type: 'image_url',
image_url: { url: message.files[0].url }
}
];
if (message?.msg) {
contentParts.push({
type: 'text',
text: message.msg
});
}
// 创建 qwen-sketch-to-image 模型
const model = this.createModel('qwen-sketch-to-image');
const modelResponse = await model.generateText({
messages: [
{
role: 'user',
content: contentParts,
},
],
parameters: {
style: '<watercolor>', // 示例：水彩风格
n: 1, // 生成 1 张图片
sketch_weight: 9, // 草图权重
sketch_extraction: true // 启用边缘提取
}
});
// 非流式：直接返回生成的图片结果
return modelResponse;
} catch (error) {
console.error('qwen-sketch-to-image error:', error);
return {
code: -1,
msg: '涂鸦生图失败，请稍后重试'
};
}
}