使用Postman或cURL调用图像/视频生成API

前提条件

在调用API之前，您需要开通模型服务并获取API Key，下载Postman到本地。

步骤1：创建任务

我们将根据下面的 cURL 命令来配置 Postman。

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": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'    

1. 配置请求方法、URL、请求头 (Headers)

   • 配置Authorization时，对应的值为Bearer sk-xxxx。请将 sk-xxxx替换为真实的 API Key。

   

2. 配置请求体 (Body)

   • 选择 Body -> raw -> JSON，将cURL中的 -d 内容粘贴到输入框。

   • 点击页面右侧的 Beautify 按钮，对body参数进行格式化。

   • 点击send发送请求。

   

3. 发送请求并获取 task_id

   • 当请求成功时，您将在响应体中看到 task_id。

   

   说明

   task_id有效期为24小时，超时后将无法查询，请及时使用task_id获取生成的结果。

步骤2：根据task_id查询结果

根据查询结果的cURL 命令，配置Postman。

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

1. 配置请求方法 、URL、请求头 (Headers)

   • 配置URL时，需要将{task_id} 替换为在步骤1中获取的 task_id。

   • 配置Authorization时，对应的值为Bearer sk-xxxx。请将 sk-xxxx替换为真实的 API Key。

   

   说明

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

前提条件

在执行cURL命令之前，您需要：

• 已开通模型服务并获取API Key。

• 确保您的系统中已安装 cURL，并配置API Key到环境变量，方便后续直接引用$DASHSCOPE_API_KEY变量。

  检查是否已安装cURL

  运行以下命令，检查 cURL 是否已安装。

  curl --version

  如果看到类似如下输出，说明cURL已安装：

  curl 8.x.x (x86_64-apple-darwin23.0) libcurl/8.x.x (SecureTransport) LibreSSL/3.3.6 zlib/1.2.12 nghttp2/1.58.0
  Release-Date: 2023-10-11
  Protocols: dict file ftp ftps gopher gophers http https imap imaps ldap ldaps mqtt pop3 pop3s rtsp smb smbs smtp smtps telnet tftp
  Features: alt-svc AsynchDNS GSS-API HSTS HTTP2 HTTPS-proxy IPv6 Kerberos Largefile libz MultiSSL NTLM NTLM_WB SPNEGO SSL threadsafe UnixSockets

  如果没有安装，可能会给出以下类似提示：

  • Windows: 'curl' 不是内部或外部命令，也不是可运行的程序或批处理文件。

  • Linux/macOS: command not found: curl。

  替代方案：推荐您使用Postman发送请求。

步骤1：创建任务

• 打开您的终端（Terminal, PowerShell, CMD等），复制以下命令到终端并执行。

  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": "wanx2.1-t2i-turbo",
      "input": {
          "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
      },
      "parameters": {
          "size": "1024*1024",
          "n": 1
      }
  }'    

• 成功请求后将返回task_id。

  

  说明

  task_id有效期为24小时，超时后将无法查询，请及时使用task_id获取生成的结果。

步骤2：根据task_id查询结果

• 将以下命令中的 {task_id} 替换为步骤 1 中获取的任务 ID，复制命令到终端并执行。

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

• 成功请求后将返回图像 URL。

  

  说明

  • 由于模型处理时间较长（十几秒到几分钟不等），单次查询可能无法立即获取结果，建议稍作等待后重试几次。

  • 图像URL有效期为24小时，请及时下载。

HTTP调用示例（文生图）