背景生成

图像背景生成 — 查询结果

查询图像背景生成任务的状态和结果

GET

/tasks/{task_id}

cURL — 查询任务结果

# 将 {task_id} 替换为创建任务接口返回的真实 task_id
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "ded2407a-ec61-4a7d-adc0-xxxxxxxxxxxx",
  "output": {
    "task_id": "86ecf553-d340-4e21-xxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-12-23 10:25:26.436",
    "scheduled_time": "2025-12-23 10:25:26.471",
    "end_time": 使用 API
获取 API Key
配置 API Key
安装 SDK
对话模型
POST
OpenAI Chat
POST
Anthropic 兼容
POST
DashScope
图像生成 API
POST
Qwen
POST
同步调用
POST
创建任务
GET
查询结果
,
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      }
    ],
    "task_metrics": {
      "TOTAL": 4,
      "SUCCEEDED": 4,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 4
  }
}

请先获取 API Key 并设置为环境变量。

鉴权

string

header

必填

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

Header 参数

string

必填

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

路径参数

string

必填

创建任务接口返回的任务 ID。

响应

200-application/json

string

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

示例:ded2407a-ec61-4a7d-adc0-xxxxxxxxxxxx

object

任务输出信息。

显示子属性

string

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

示例:86ecf553-d340-4e21-xxxxxxxxx

enum<string>

任务状态。

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

string

任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-12-23 10:25:26.436

string

任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-12-23 10:25:26.471

string

任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-12-23 10:26:06.390

object[]

返回结果图像。仅在 task_status 为 SUCCEEDED 时返回。图像分辨率与输入图像（base_image_url）保持一致。

显示子属性

string

生成图像的 URL。有效期 24 小时，请及时下载保存。

示例:https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx

string

错误码。仅在 task_status 为 FAILED 时返回。

示例:InvalidParameter.FileDownload

string

错误详情。仅在 task_status 为 FAILED 时返回。

示例:download for input_image error

object

任务结果统计。

显示子属性

integer

总的任务数。

示例:4

integer

任务状态为成功的任务数。

示例:4

integer

任务状态为失败的任务数。

示例:0

object

输出信息统计。计费公式：费用 = 图片数量 × 单价。

显示子属性

integer

模型成功生成图片的数量。

示例:4

cURL — 查询任务结果

# 将 {task_id} 替换为创建任务接口返回的真实 task_id
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "ded2407a-ec61-4a7d-adc0-xxxxxxxxxxxx",
  "output": {
    "task_id": "86ecf553-d340-4e21-xxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-12-23 10:25:26.436",
    "scheduled_time": "2025-12-23 10:25:26.471",
    "end_time": "2025-12-23 10:26:06.390",
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
      }
    ],
    "task_metrics": {
      "TOTAL": 4,
      "SUCCEEDED": 4,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 4
  }
}

万相2.6

Wan 2.6 — 创建任务

Wan 2.6 异步图像生成与编辑

POST

/services/aigc/image-generation/generation

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
  "model": "wan2.6-image",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "Generate a tomato and egg stir-fry based on the style of image 1 and the background of image 2"
          },
          {
            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
          },
          {
            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
          }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "watermark": false,
    "n": 1,
    "enable_interleave": false,
    "size": "1K"
  }
}'