本文介绍使用Postman和cURL调用阿里云百炼的图像或视频生成 API。以“文生图”为例，演示从创建任务到获取结果的完整流程。
Postman：一款界面化的 HTTP 测试工具，操作直观，推荐初学者使用。
cURL：一个强大的命令行工具，适用于熟悉命令行的开发者。
Postman 和 cURL仅适用于快速测试与功能验证。对于生产环境，建议您使用官方 SDK 或自行实现 HTTP 调用。
API异步调用机制
由于图像与视频生成任务耗时较长（十几秒到数分钟不等），为避免长时间的HTTP连接等待和超时，API采用异步调用机制。整个调用过程分为两步：
创建任务：调用 API 创建任务，服务会同步返回一个任务 ID（task_id）。
查询结果：使用该 task_id，通过轮询方式查询任务状态，直到任务完成并获取最终的图像或视频 URL。
HTTP调用示例（文生图）
方式一：使用Postman发送请求（推荐）
如何根据 cURL 配置 Postman？
前提条件
在调用API之前，您需要根据地域获取API Key，下载Postman到本地。
步骤1：创建任务
我们将根据下面的 cURL 命令来配置 Postman。
以下为中国大陆（北京）地域base_url，若使用国际（新加坡）地域的模型，需将base_url替换为https://dashscope-intl.aliyuncs.com/api/v1/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": "wan2.5-t2i-preview",
"input": {
"prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
},
"parameters": {
"size": "1024*1024",
"n": 1
}
}'在 Postman 中，单击new或
+按钮创建一个新请求，请求类型选择HTTP。在请求方法下拉菜单中选择POST，并根据您的模型所在地域填入对应的 URL：
中国大陆（北京）地域：https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis
国际（新加坡）地域：https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis
点击Headers标签页，添加以下三个键值对。
Key
Value
说明
X-DashScope-Async
enable
启用异步调用
Authorization
Bearer sk-xxx（请将sk-xxx替换为阿里云百炼API Key）
身份验证凭证
Content-Type
application/json
声明请求体为JSON格式
配置请求体 (Body)
点击 Body 标签页，选中 raw 单选框，然后在右侧的格式下拉菜单中选择JSON，将cURL示例中的
-d后面的 JSON 内容粘贴到输入框。{ "model": "wan2.5-t2i-preview", "input": { "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵" }, "parameters": { "size": "1024*1024", "n": 1 } }（可选）点击页面右侧的
Beautify，可以格式化JSON格式，使其更易阅读。
点击Send发送请求，并获取
task_id。有效期 24 小时，过期后无法查询，请及时获取结果。
步骤2：根据task_id查询结果
获取到 task_id 后，需要通过查询接口来获取最终结果。
以下为中国大陆（北京）地域base_url，若使用国际（新加坡）地域的模型，需将base_url替换为https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"在 Postman 中配置查询请求：
新建一个HTTP请求。
配置请求方法为GET 。
根据地域，填入查询URL，将URL中的
{task_id}替换为在步骤1中获取的真实 task_id。在Headers标签页中，添加 Authorization 键，其值与步骤1中使用的 API Key 相同。
点击Send发送请求。
检查返回结果。重复发送此请求（轮询），直到 task_status 变为 SUCCEEDED，获取图像的URL。图像URL有效期为24小时，请及时下载。
方式二：使用cURL发送请求
熟悉命令行的开发者可使用cURL快速测试API。
前提条件
在执行cURL命令之前，您需要：
确保您的系统中已安装 cURL，并配置API Key到环境变量，方便后续直接引用
$DASHSCOPE_API_KEY变量。
步骤1：创建任务
在终端执行以下命令：
以下为中国大陆（北京）地域base_url，若使用国际（新加坡）地域的模型，需将base_url替换为https://dashscope-intl.aliyuncs.com/api/v1/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": "wan2.5-t2i-preview", "input": { "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵" }, "parameters": { "size": "1024*1024", "n": 1 } }'成功请求后将返回
task_id。有效期 24 小时，过期后无法查询。请及时获取结果。
步骤2：根据task_id查询结果
将以下命令中的
{task_id}替换为步骤 1 中获取的任务 ID，复制命令到终端并执行。以下为中国大陆（北京）地域base_url，若使用国际（新加坡）地域的模型，需将base_url替换为https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"当任务处理完成（
task_status为SUCCEEDED）时，响应中将包含图像URL。图像URL有效期为24小时，请及时下载。由于模型处理时间较长（十几秒到几分钟不等），您可能需要轮询本接口。建议每隔3-5秒查询一次，直到
task_status不为RUNNING。
下一步
成功生成第一张图片后，您还可进行以下探索：