跳转至

万相 2.5 文生图

阿里云百炼万相 2.5 文生图模型,支持扩展尺寸(如 768×2700),异步调用,512~1440 像素。

模型信息

属性
模型ID wan2.5-t2i-preview
任务类型 text-to-image
输入 文本提示词(最长 2100 字符)
输出 图像(URL,24小时有效)
分辨率范围 宽/高 512~1440 像素

API 调用

端点

创建任务(异步):

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

查询任务结果:

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

请求头

参数 类型 必填 说明
Content-Type string application/json
Authorization string Bearer sk-xxxx
X-DashScope-Async string 必须设为 enable

请求参数

参数 类型 必填 默认值 取值范围 说明
model string wan2.5-t2i-preview 模型ID
input.prompt string 最长 2100 字符 正向提示词
input.negative_prompt string 最长 500 字符 反向提示词
parameters.size string 1024*1024 宽/高 512~1440 像素 输出分辨率,格式 宽*高
parameters.n integer 4 1~4 生成图片数量
parameters.prompt_extend boolean true true/false 启用提示词优化
parameters.watermark boolean false true/false 添加"AI生成"水印
parameters.seed integer 随机 0~2147483647 随机种子

请求示例

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": "wan2.5-t2i-preview",
    "input": {
      "prompt": "一只小猫在月光下奔跑",
      "negative_prompt": "低质量"
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1,
      "prompt_extend": true
    }
  }'

查询任务结果

curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应示例(任务创建)

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

响应示例(任务完成)

{
  "request_id": "2ddf53fa-699a-4267-9446-xxxxxx",
  "output": {
    "task_id": "3cd3fa4e-53ee-4136-9cab-xxxxxx",
    "task_status": "SUCCEEDED",
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png",
        "orig_prompt": "原始提示词",
        "actual_prompt": "优化后的提示词"
      }
    ],
    "task_metrics": {"TOTAL": 1, "SUCCEEDED": 1, "FAILED": 0}
  },
  "usage": {"image_count": 1}
}

任务状态

状态 说明
PENDING 排队中
RUNNING 处理中
SUCCEEDED 成功
FAILED 失败
CANCELED 已取消
UNKNOWN 未知/已过期

计费

模型 价格 免费额度
wan2.5-t2i-preview 0.20 元/张 50 张

按成功生成的图片张数计费。图片 URL 24 小时内有效,请及时下载。

数据来源

  • API 参考:https://help.aliyun.com/zh/model-studio/text-to-image-v2-api-reference
  • 计费信息:https://help.aliyun.com/zh/model-studio/model-pricing