需掌握身份认证、请求构造、响应解析及计费规则：一、配置API密钥；二、构建POST请求；三、用SDK简化调用；四、按量计费（日赠50次，0.16元/张）；五、Java中用Spring AI Alibaba集成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在应用程序中集成通义万象的图像生成能力，但尚未明确其调用流程与费用结构，则需分别掌握身份认证、请求构造、响应解析等环节，并了解不同计费模型下的成本触发条件。以下是具体操作路径：
一、获取并配置API密钥
通义万象要求每次请求携带有效的身份凭证，该凭证由阿里云控制台生成并绑定至具体服务权限。未配置合法密钥将导致401错误。
1、登录阿里云控制台，进入DashScope管理页面。
2、在“API密钥管理”中创建新的AccessKey，记录下AccessKey ID与AccessKey Secret。
3、将AccessKey Secret设置为环境变量AI_DASHSCOPE_API_KEY，或在代码中以明文方式传入（仅限测试环境）。
4、确认已开通“通义万相”服务，且所在地域支持该模型调用。
二、构建标准HTTP请求
通义万象采用RESTful风格接口，所有请求均需通过POST方法发送至指定端点，并携带必要头信息与JSON格式载荷。不支持GET方式提交提示词。
1、使用基础URL：https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis。
2、设置请求头：包含Authorization: Bearer {your_api_key}与Content-Type: application/json。
3、构造JSON载荷：至少包含model、input.prompt、parameters.size三项字段，其中model值应为wanx-v1或wan2.2-t2i-flash等有效模型标识。
4、启用异步模式时，在请求头中添加X-DashScope-Async: enable，此时返回task_id用于后续轮询。
三、使用DashScope SDK简化调用
官方SDK封装了签名生成、重试机制与异常分类逻辑，可避免手动处理Base64编码与HMAC-SHA256签名过程，降低出错概率。
1、执行命令安装Python SDK：pip install dashscope。
2、导入ImageSynthesis模块并调用call方法，传入prompt、model、size等参数。
3、检查response.status_code是否为200，若成功则从response.output.image读取二进制图像数据。
4、对异步任务，使用ImageSynthesis.async_result(task_id)持续查询直至status变为success。
四、按量计费规则说明
通义万象采用调用次数与输出规格双重计费维度，免费额度按自然日重置，超出后即时扣费，不设月结周期。
1、每日赠送50次免费调用额度，适用于wanx-v1及wan2.2-t2i-flash模型。
2、超出部分按单张图片计费：0.16元/张（依据Dify接入指南中wanx-v1标准）。
3、高分辨率输出（如1024×1024）不额外加价，但同一请求中n参数大于1时，按生成张数累加计费。
4、账户余额不足时，API将返回402状态码，请求被拒绝，不会产生欠费。
五、Java环境下的Spring Boot集成
在企业级Java应用中，可通过Spring AI Alibaba Starter实现自动装配与类型安全调用，避免硬编码HTTP客户端逻辑。
1、在pom.xml中引入依赖：spring-ai-alibaba-spring-boot-starter与对应版本的dashscope-sdk-java。
2、配置application.yml，设置dashscope.api-key与dashscope.base-url。
3、注入TextToImageClient Bean，调用generate方法传入TextToImageRequest对象。
4、捕获TextToImageResponse异常，区分InvalidParameterException与RateLimitExceededException等具体错误类型。
