需通过API接口集成通义万象图像生成能力，流程包括开通服务获取密钥、构造异步HTTP请求、使用SDK简化开发、小程序需后端代理、Dify支持低代码编排。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将通义万象的AI图像生成能力集成到自有系统中，则需通过其官方提供的API接口进行开发对接。通义万象不提供前端嵌入式组件或免代码接入方式，所有外部调用均依赖标准HTTP协议与身份鉴权机制。以下是可行的对接路径：
一、开通API服务并获取密钥凭证
该步骤是调用通义万象API的前提，用于建立合法身份与权限边界，确保请求可被阿里云后端识别并计费。
1、登录阿里云控制台，进入DashScope控制台，在产品列表中定位「通义万相」。
2、点击「API服务」页签，勾选「文本生成图像（T2I）」和「图像生成图像（I2I）」两项能力，完成服务开通。
3、前往「AccessKey管理」页面，创建一对新的AccessKey ID与AccessKey Secret；务必为该密钥配置最小权限RAM策略，仅授权wanxiang:GenerateImage等必要动作。
4、在API文档页确认当前可用模型名称，例如wanx-v1或wan2.2-t2i-flash，并记录对应的服务端点URL。
二、构造符合规范的HTTP请求
通义万象采用异步任务模式，需先提交生成请求获取task_id，再轮询结果。请求必须携带签名认证头与结构化JSON载荷，以触发云端渲染流程。
1、设置请求头：包含Authorization: Bearer {API_KEY}、Content-Type: application/json及X-DashScope-Async: enable标识异步模式。
2、构建POST请求体，其中input.prompt字段填写中文或英文描述，parameters.size指定输出尺寸（如"1024*1024"），parameters.n设为生成张数（最大值依配额而定）。
3、发送请求至端点https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis，成功响应将返回task_id与task_status: PENDING。
4、使用该task_id向https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}发起GET请求，直至task_status变为SUCCEEDED，从results[0].url提取图片直链。
三、通过SDK简化集成流程
阿里云官方提供多语言SDK，封装了签名生成、重试逻辑与异常分类，可规避手动构造请求头的出错风险，提升开发效率与稳定性。
1、在Maven项目中添加依赖：aliyun-java-sdk-wanxiang或spring-ai-alibaba（适配Spring Boot 3.3+）。
2、初始化客户端时传入API Key，例如QwenClient client = new QwenClient("your_api_key");。
3、创建TextToImageRequest对象，设置prompt、size、style等参数，调用client.textToImage(request)方法。
4、SDK自动处理异步轮询，默认超时60秒，返回结果中直接包含imageUrl字段，无需手动解析JSON响应体。
四、在微信小程序中调用API
受限于小程序安全策略，无法直接使用AccessKey Secret，须通过自建中转服务代理请求，避免密钥暴露在前端代码中。
1、在小程序端收集用户输入的提示词与风格选项，调用自身后端接口（如/api/generate）。
2、后端服务使用Node.js或Python接收请求，拼装标准DashScope API调用参数，并携带已预存的API Key发起HTTPS请求。
3、后端收到SUCCEEDED状态后，将OSS临时签名URL或base64编码图像数据返回给小程序。
4、小程序前端通过wx.downloadFile或<image>标签渲染结果；严禁在wx.request中直接填入AccessKey Secret，否则将导致密钥泄露与账户盗用风险。
五、使用Dify Pipeline实现低代码编排
对于无开发资源但需快速落地AI绘图流程的团队，可通过Dify平台配置可视化工作流，将通义万象API作为原子节点嵌入自动化链条。
1、在Dify中新建Application，选择「Custom LLM」类型，添加「Text to Image」工具节点。
2、配置节点参数：模型选择wanx-v1，API Key填入环境变量DASHSCOPE_API_KEY，设定默认size与style。
3、连接用户输入框（Prompt Input）与图像输出模块（Image Output），启用「自动执行」开关。
4、发布应用后获取Webhook地址，在网页表单中通过fetch调用该地址，即可获得带Markdown格式图片链接的响应体。
