支持的模型

调用流程

接口采用异步任务模式，分两步执行：

step1：调用创建任务接口，成功返回task_id

step2：调用查询任务接口查询对应task_id，直到task_status值为SUCCEEDED，获取生成图片url

接口详情

创建任务接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/services/aigc/multimodal-generation/generation

请求头

请求参数

同步成功响应参数

异步成功响应参数

查询任务接口详情

http调用

请求方式：GET

请求路径：https://ai.ctaigw.cn/v1/tasks/{task_id}

Path 路径参数

请求头 Headers

响应参数

请求/响应示例

同步/异步创建任务示例

如果异步，则加上请求头"X-DashScope-Async: enable"

创建任务请求示例

文生图

curl --location 'https://ai.ctaigw.cn/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ${YOUR_APP_KEY}" \
--data '{
    "model": "qwen-image-2.0-pro",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "山间木质观景台，秋日清晨薄雾，柔和自然光，写实摄影"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "prompt_extend": true,
        "watermark": false,
        "size": "2048*2048"
    }
}'

成功响应示例

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://aaaa.ctyun.cn/pic/3.jpg"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ]
    },
    "usage": {
        "height": 2048,
        "image_count": 1,
        "width": 2048
    },
    "request_id": "00d06a841873c0a83bfaf1fae0184625"
}

异常响应示例

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

查询任务示例

查询任务请求示例

curl -X GET https://ai.ctaigw.cn/v1/tasks/{task_id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"

正常响应示例

{
    "request_id": "00d06a841873c0a83bfaf1fae0184625",
    "output": {
          "task_id": "xxxx‑xxxx‑xxxx‑xxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-08-26 12:10:05.001",
        "scheduled_time": "2026-08-26 12:10:05.201",
        "end_time": "2026-08-26 12:10:25.001",
        "results": [
            {
                "url": "https://aaaa.ctyun.cn/pic/3.jpg"
            }
        ]
    },
    "usage": {
        "image_count": 1
    }
}