CreateImageTask - 创建图片生成任务-AI 数智鉴密(AI DeepSign )-阿里云帮助中心

接口说明

请求说明

本接口用于创建 AI 图片生成任务，系统将依据用户提供的正向提示词（Prompt）生成相应的图片。
支持配置反向提示词、模型选择、图片尺寸等参数以优化生成效果。
默认情况下，生成的图片会自动嵌入 C2PA 数字签名；可选是否添加右下角水印。
通过设置ClientToken参数可以保证请求的幂等性，确保在不同请求间唯一。
创建任务后，使用TaskId调用GetImageTaskResult接口查询生成结果。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。`ClientToken` 只支持 ASCII 字符，且不能超过 64 个字符。	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
Prompt	string	否	图片描述文字（正向提示词），不超过 800 字符。	一间全是猫的会议室
NegativePrompt	string	否	反向提示词，不超过 500 字符。	低质量,模糊,变形
Model	string	否	模型名称，默认 `qwen-image-2.0-pro`。	qwen-image-2.0-pro
Size	string	否	图片尺寸（格式宽高），默认 `20482048`。	1024*1024
N	integer	否	生成数量（1~6），默认 `1`。	1
Seed	integer	否	随机种子（0~2147483647），0 表示随机。	42
PromptExtend	boolean	否	是否开启提示词智能改写，默认 true

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
TaskId	string	任务 ID，用于调用 `GetImageTaskResult` 查询结果。	f47ac10b-58cc-4372-a567-0e02b2c3d479
Success	boolean	表示是否调用成功。true：调用成功。 false：调用失败。
Message	string	附加信息。请求成功时返回 `success`。	success
HttpStatusCode	integer	HTTP 状态码。请求成功时返回 `200`。	200
Code	string	业务错误码。请求成功时返回 `OK`。	OK

示例

正常返回示例

JSON格式

{
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "TaskId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "Success": true,
  "Message": "success",
  "HttpStatusCode": 200,
  "Code": "OK"
}

错误码

HTTP status code	错误码	错误信息	描述
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。