GET/tasks/{task_id}cURL — 获取任务结果cURL复制curl --location --request GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"200SUCCEEDED复制{ "request_id": "f24149fe-4722-9763-xxxxxx", "output": { "task_id": "9d62befa-0139-4e4d-xxxxxx", "task_status": "SUCCEEDED", "submit_time": "2025-04-24 10:51:35.004", "scheduled_time": "2025-04-24 10:51:35.033", "end_time": "2025-04-24 10:51:59.424", "results": [ { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_1.png" }, { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_2.png" } ], "task_metrics": { "TOTAL": 2, "SUCCEEDED": 2, "FAILED": 0 } }, "usage": { "image_count": 2 } }请先获取 API Key 并设置为环境变量。鉴权文生视频视频编辑图生动作视频换人数字人图生舞蹈视频图生唱演视频图生播报视频视频口型替换图生表情包视频视频风格重绘可灵视频生成3D 生成 APITripo专项模型 APIPOSTDeep Research APIGUI-PlusQwen-MTQwen-OCR语音合成CosyVoiceSambertQwen-TTSMiniMax语音识别ParaformerFun-ASRQwen-ASR定制热词语音对话Qwen-Omni-RealtimeQwen-Livetranslate音乐生成POSTFun-Music图片翻译Qwen-MT-Image文本向量POSTOpenAI 兼容POSTDashScope多模态向量POSTDashScope重排序POSTOpenAI 兼容POSTDashScope平台 API会话文件批量工具包与框架OpenAI 兼容更多错误信息临时 API Key上传文件获取临时 URL管理异步任务异步任务管理 API连接池可灵图像生成创建图像生成任务复制本文提交可灵图像生成任务（文生图或参考图生图），获取 task_id 用于后续查询。复制本文POST/services/aigc/image-generation/generationcURL文生图复制curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \ --header 'X-DashScope-Async: enable'Authorizationstringheader必填千问云 API Key。详见获取 API Key。路径参数task_idstring必填创建任务接口返回的任务ID。响应200-application/jsonrequest_idstring请求唯一标识。可用于请求明细溯源和问题排查。示例:f24149fe-4722-9763-xxxxxxoutputobject任务输出信息。显示子属性output.task_idstring任务ID。示例:9d62befa-0139-4e4d-xxxxxxoutput.task_statusenum<string>任务状态。 PENDING：排队中 RUNNING：处理中 SUSPENDED：挂起 SUCCEEDED：执行成功 FAILED：执行失败 UNKNOWN：任务不存在或状态未知 可选值：PENDING,RUNNING,SUCCEEDED,FAILED,SUSPENDED,UNKNOWNoutput.submit_timestring任务提交时间。示例:2025-04-24 10:51:35.004output.scheduled_timestring任务排期执行时间。示例:2025-04-24 10:51:35.033output.end_timestring任务完成时间。示例:2025-04-24 10:51:59.424output.resultsobject[]任务结果列表，包括图像URL。仅在 task_status 为 SUCCEEDED 时返回。显示子属性output.results.urlstring模型生成图片的URL地址。示例:https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_1.pngoutput.result_urlstring输出图片URL。output.codestring任务执行失败的错误码。仅在 task_status 为 FAILED 时返回。示例:InvalidImageResolutionoutput.messagestring任务执行失败的详细信息。仅在 task_status 为 FAILED 时返回。示例:The input image resolution is too large or smalloutput.task_metricsobject任务信息统计指标。显示子属性output.task_metrics.TOTALinteger总的任务数。示例:2output.task_metrics.SUCCEEDEDinteger任务状态为成功的任务数。示例:2output.task_metrics.FAILEDinteger任务状态为失败的任务数。示例:0usageobject输出信息统计。仅在任务成功时返回。显示子属性usage.image_countinteger模型生成图像的数量。示例:2上一页鞋靴模特 — 创建任务异步鞋靴模特图像生成下一页cURL — 获取任务结果cURL复制curl --location --request GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"200SUCCEEDED复制{ "request_id": "f24149fe-4722-9763-xxxxxx", "output": { "task_id": "9d62befa-0139-4e4d-xxxxxx", "task_status": "SUCCEEDED", "submit_time": "2025-04-24 10:51:35.004", "scheduled_time": "2025-04-24 10:51:35.033", "end_time": "2025-04-24 10:51:59.424", "results": [ { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_1.png" }, { "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_2.png" } ], "task_metrics": { "TOTAL": 2, "SUCCEEDED": 2, "FAILED": 0 } }, "usage": { "image_count": 2 } }千问云 home page文档API 与 SDK 参考使用 API获取 API Key配置 API Key安装 SDK对话模型POSTOpenAI ChatOpenAI ResponsesPOSTAnthropic 兼容POSTDashScope图像生成 API文生图图像编辑涂鸦作画图像局部重绘人像风格重绘图像外扩虚拟模特POST创建任务GET查询结果鞋靴模特创意海报人体实例分割背景生成图像擦除补全AI 试穿人像写真创意文字可灵图像生成视频生成 API图生视频参考视频生成文生视频视频编辑图生动作视频换人数字人图生舞蹈视频图生唱演视频图生播报视频视频口型替换图生表情包视频视频风格重绘可灵视频生成3D 生成 APITripo专项模型 APIPOSTDeep Research APIGUI-PlusQwen-MTQwen-OCR语音合成CosyVoiceSambertQwen-TTSMiniMax语音识别ParaformerFun-ASRQwen-ASR定制热词语音对话Qwen-Omni-RealtimeQwen-Livetranslate音乐生成POSTFun-Music图片翻译Qwen-MT-Image文本向量POSTOpenAI 兼容POSTDashScope多模态向量POSTDashScope重排序POSTOpenAI 兼容POSTDashScope平台 API会话文件批量工具包与框架OpenAI 兼容更多 \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "model": "kling/kling-v3-image-generation", "input": { "messages": [ { "role": "user", "content": [ { "text": "一间有着精致窗户的花店,漂亮的木质门,摆放着花朵" } ] } ] }, "parameters": { "n": 2, "aspect_ratio": "1:1", "resolution": "1k" } }'4XX200复制{ "code": "InvalidApiKey", "message": "No API-key provided.", "request_id": "7438d53d-6eb8-4596-8835-xxxxxx" }鉴权Authorizationstringheader必填千问云 API Key。详见获取 API Key。Header 参数X-DashScope-Asyncenum<string>必填异步处理配置参数。HTTP请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。可选值：enable请求体application/jsonmodelenum<string>必填模型名称。可选值：kling/kling-v3-image-generation,kling/kling-v3-omni-image-generationinputobject必填输入参数对象。显示子属性input.messagesobject[]必填请求内容数组。当前仅支持单轮对话，因此数组内有且只有一个对象，该对象包含 role 和 content 两个属性。显示子属性input.messages.roleenum<string>消息的角色。此参数必须设置为 user。可选值：userinput.messages.contentobject[]消息内容，包含文本提示词（text）和可选的参考图像（image，支持多张）。显示子属性input.messages.content.textstring正向提示词，用于描述期望生成的图像内容、风格和构图。支持中英文，长度不超过2500个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断。注意：仅支持传入一个text，不传或传入多个将报错。示例值：一只坐着的橘黄色的猫，表情愉悦，活泼可爱，逼真准确。input.messages.content.imagestring参考图像的URL。支持 HTTP 或 HTTPS 协议。示例值：https://xxx/xxx.png。图像限制：格式为JPEG、JPG、PNG（不支持透明通道）；宽和高的范围为[300, 8000]像素；宽高比在1:2.5 ~ 2.5:1之间；文件大小不超过10MB；参考图片数量和参考主体数量（element_list数组长度）之和不得超过10。input.element_listobject[]主体列表，用于指定需要保持的主体。参考图片数量和参考主体数量（element_list数组长度）之和不得超过10。显示子属性input.element_list.element_idinteger传 element_list 时必填，表示主体ID。请在可灵-主体ID列表获取主体ID。参考图片数量和参考主体数量（element_list数组长度）之和不得超过10。parametersobject控制图像生成，比如图像张数、宽高比等。显示子属性parameters.ninteger生成的图像张数。 kling/kling-v3-image-generation：取值范围为1～9，默认值为1。 kling/kling-v3-omni-image-generation：当且仅当 result_type=single 时生效，取值范围为1～9，默认值为1。 parameters.result_typeenum<string>生成图像的类型。仅支持模型 kling/kling-v3-omni-image-generation。 single（默认值）：单图。批量生成时仅风格相似，无分镜关联。 series：组图。生成具有叙事/视觉连续性的分镜系列图像。 可选值：single,seriesparameters.series_amountinteger组图模式下的输出张数。仅支持模型 kling/kling-v3-omni-image-generation。取值范围为2～9，默认值为4。当且仅当 result_type=series 时生效。parameters.aspect_ratioenum<string>默认值"16:9"输出图像的宽高比。示例值：16:9。可选值：16:9,9:16,1:1parameters.resolutionenum<string>输出图像分辨率。 kling/kling-v3-image-generation：可选值为 1k、2k，默认值为 1k。 kling/kling-v3-omni-image-generation：可选值为 1k、2k、4k，默认值为 1k。 示例值：1k。 可选值：1k,2k,4kparameters.watermarkboolean默认值false是否添加水印标识。水印位于图像右下角，文案固定为"可灵AI"。 false（默认值）：不添加水印。 true：添加水印。 示例值：false。 响应4XX-application/jsoncodestring请求失败的错误码。messagestring请求失败的详细信息。request_idstring请求唯一标识。
POST/services/aigc/image-generation/generationcURL文生图复制curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \ --header 'X-DashScope-Async: enable'Authorizationstringheader必填千问云 API Key。详见获取 API Key。路径参数task_idstring必填创建任务接口返回的任务ID。响应200-application/jsonrequest_idstring请求唯一标识。可用于请求明细溯源和问题排查。示例:f24149fe-4722-9763-xxxxxxoutputobject任务输出信息。显示子属性output.task_idstring任务ID。示例:9d62befa-0139-4e4d-xxxxxxoutput.task_statusenum<string>任务状态。 PENDING：排队中 RUNNING：处理中 SUSPENDED：挂起 SUCCEEDED：执行成功 FAILED：执行失败 UNKNOWN：任务不存在或状态未知 可选值：PENDING,RUNNING,SUCCEEDED,FAILED,SUSPENDED,UNKNOWNoutput.submit_timestring任务提交时间。示例:2025-04-24 10:51:35.004output.scheduled_timestring任务排期执行时间。示例:2025-04-24 10:51:35.033output.end_timestring任务完成时间。示例:2025-04-24 10:51:59.424output.resultsobject[]任务结果列表，包括图像URL。仅在 task_status 为 SUCCEEDED 时返回。显示子属性output.results.urlstring模型生成图片的URL地址。示例:https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/test_1.pngoutput.result_urlstring输出图片URL。output.codestring任务执行失败的错误码。仅在 task_status 为 FAILED 时返回。示例:InvalidImageResolutionoutput.messagestring任务执行失败的详细信息。仅在 task_status 为 FAILED 时返回。示例:The input image resolution is too large or smalloutput.task_metricsobject任务信息统计指标。显示子属性output.task_metrics.TOTALinteger总的任务数。示例:2output.task_metrics.SUCCEEDEDinteger任务状态为成功的任务数。示例:2output.task_metrics.FAILEDinteger任务状态为失败的任务数。示例:0usageobject输出信息统计。仅在任务成功时返回。显示子属性usage.image_countinteger模型生成图像的数量。示例:2