万相涂鸦作画 — 创建任务

POST

/services/aigc/image2image/image-synthesis

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx-sketch-to-image-lite",
    "input": {
        "sketch_image_url": "https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6609471071/p743851.jpg",
        "prompt": "一棵参天大树"
    },
    "parameters": {
        "size": "768*768",
        "n": 2,
        "sketch_weight": 3,
        "style": "<watercolor>"
    }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Format:token

请求体

application/json

string

必填

调用模型，固定为 wanx-sketch-to-image-lite。

示例:wanx-sketch-to-image-lite

object

必填

输入的基本信息，比如提示词、图像URL地址。

显示子属性

string

必填

提示词，用来描述生成图像中期望包含的元素和视觉特点。支持中英文，长度不超过75个字符，超过部分会自动截断。

示例:一棵参天大树

string

必填

输入草图的URL地址。输入草图需要与输出图像的分辨率比例保持一致，否则会导致图片拉伸变形，建议使用白色背景图。URL需为公网可访问的地址，并支持HTTP或HTTPS协议，URL地址中不能包含中文字符。图像格式支持JPG、JPEG、PNG、TIFF、WEBP。图像分辨率不小于256×256像素且不超过2048×2048像素。图像大小不超过10 MB。

object

图像处理参数。

显示子属性

enum<string>

默认值"<auto>"

输出图像的风格。

可选值：<auto>,<3d cartoon>,<anime>,<oil painting>,<watercolor>,<sketch>,<chinese painting>,<flat illustration>

string

默认值"768*768"

输出图像的分辨率。目前仅支持一种图像分辨率：768*768，且为默认值。

integer

默认值4

生成图片的数量。取值范围为1~4张，默认为4。

取值范围：1 <= x <= 4

integer

默认值10

输入草图对输出图像的约束程度。取值范围为0-10，取值间隔为1，默认值为10。取值越大表示输出图像跟输入草图越相似。

取值范围：0 <= x <= 10

boolean

默认值false

如果上传图片是RGB图片，而非草图（sketch线稿），此参数可控制是否对输入图片进行sketch边缘提取。默认值为False，表示不进行提取。设置为True时，表示进行提取，此时sketch_color字段失效。

integer[][]

默认值[]

此字段在sketch_extraction=false时生效，所包含数值均被视为画笔色，其余数值均会视为背景色。模型会基于一种或多种画笔色描绘的区域生成新的画作。默认值为[]。当sketch_image_url线稿中的线条不是黑色，而是包含其他一种或多种颜色时，可以指定一个或多个RGB颜色数值作为画笔色。

示例:

响应

200-application/json

object

任务输出信息。

显示子属性

string

任务ID。查询有效期24小时。

enum<string>

任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

请求唯一标识。可用于请求明细溯源和问题排查。

string

请求失败的错误码。请求成功时不会返回此参数。

string

请求失败的详细信息。请求成功时不会返回此参数。