支持的模型

调用流程

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

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

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

接口详情

前置说明：支持同步和异步调用，异步完整流程：①创建异步生图任务 → 获取 task_id；②调用本查询接口，传入 task_id 轮询获取任务状态与生成结果；

创建任务接口详情

http调用

请求方式：POST

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

请求头

请求参数

同步成功响应参数

异步成功响应参数

状态流转说明

PENDING(排队) → RUNNING(处理) → SUCCEEDED(成功)/FAILED(失败)

• 轮询时遇到PENDING/RUNNING，继续间隔轮询；

• SUCCEEDED：读取output.choices拿到图片 url；

• FAILED：读取code/message定位错误；

• UNKNOWN：task_id 不存在或已超过有效期。

查询任务接口详情

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": "wan2.7-image-pro",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {"text": "山间木质观景台，秋日清晨薄雾，柔和自然光，写实摄影"}
                ]
            }
        ]
    },
    "parameters": {
        "size": "2K",
        "n": 1,
        "watermark": false
    }
}'

图像编辑

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": "wan2.7-image-pro",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {"image": "https://aaaa.ctyun.cn/pic/1.jpg"},
                    {"image": "https://aaaa.ctyun.cn/pic/2.jpg"},
                    {"text": "图2和图1的色调互换"}
                ]
            }
        ]
    },
    "parameters": {
        "size": "2K",
        "n": 1,
        "watermark": false
    }
}'

组生图

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": "wan2.7-image-pro",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {"text": "江南古镇小巷，黄昏，暖黄路灯，烟火气息，胶片质感"}
                ]
            }
        ]
    },
    "parameters": {
        "enable_sequential": true,
        "n": 4,
        "size": "2K"
    }
}'

成功响应示例

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://aaaa.ctyun.cn/pic/3.jpg",
                            "type": "image"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ],
        "finished": true
    },
    "usage": {
        "image_count": 1,
        "input_tokens": 10022,
        "output_tokens": 3,
        "size": "1488*704",
        "total_tokens": 10025
    },
    "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",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://aaaa.ctyun.cn/pic/3.jpg",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "size": "2976*1408",
        "total_tokens": 20000,
        "image_count": 1,
        "output_tokens": 2,
        "input_tokens": 19998
    }
}

异常响应示例

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