万相V1

wanx-v1 — 创建文生图任务

wanx-v1 异步图像生成

POST

/services/aigc/text2image/image-synthesis

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx-v1",
    "input": {
        "prompt": "近景镜头，18岁的中国女孩，古代服饰，圆脸，正面看着镜头，民族优雅的服装，商业摄影，室外，电影级光照，半身特写，精致的淡妆，锐利的边缘。"
    },
    "parameters": {
        "style": "<auto>",
        "size": "1024*1024",
        "n": 1
    }
}'

{
  "code": "InvalidApiKey",
  "message": "No API-key provided.",
  "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

请先获取 API Key 并设置为环境变量。如需使用 SDK，请先安装 SDK。

wanx-v1 已停止迭代更新，推荐升级至 Wan 文生图 V2 以获取更好的效果。

鉴权

string

header

必填

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

Header 参数

enum<string>

必填

必须设置为 enable 以创建异步任务。如未设置，将返回错误："current user api does not support synchronous calls"。

可选值：enable

string

指定工作空间，格式为 ws_{workspaceId}。

请求体

application/json

string

必填

模型名称。

示例:wanx-v1

object

必填

输入内容。

显示子属性

string

必填

正向文本描述，即期望图像中出现的内容。最大 800 个字符。

取值范围：length <= 800

string

反向文本描述，即不希望图像中出现的内容。最大 500 个字符。

取值范围：length <= 500

string

参考图像 URL。支持 JPG、PNG、BMP、TIFF、WEBP 格式，大小不超过 10 MB，分辨率在 256×256 至 4096×4096 之间，URL 不能包含中文字符。

object

生成参数（可选）。

显示子属性

enum<string>

默认值"<auto>"

图像风格。

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

enum<string>

默认值"1024*1024"

图像分辨率，格式为 宽*高。

可选值：1024*1024,720*1280,768*1152,1280*720

integer

默认值4

生成图像数量。

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

integer

随机种子，用于结果复现。范围 [0, 2147483647]。

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

number

参考图强度，控制生成图像与参考图的相似程度。范围 [0.0, 1.0]，值越大越相似。

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

enum<string>

默认值"repaint"

参考图模式。repaint 基于参考图内容生成，refonly 基于参考图风格生成。

可选值：repaint,refonly

响应

4XX-application/json

string

错误码。

string

错误信息。

string

请求唯一标识。

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx-v1",
    "input": {
        "prompt": "近景镜头，18岁的中国女孩，古代服饰，圆脸，正面看着镜头，民族优雅的服装，商业摄影，室外，电影级光照，半身特写，精致的淡妆，锐利的边缘。"
    },
    "parameters": {
        "style": "<auto>",
        "size": "1024*1024",
        "n": 1
    }
}'

{
  "code": "InvalidApiKey",
  "message": "No API-key provided.",
  "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}