文章目录Spring AI Alibaba 图像模型实战文生图版本一、依赖引入二、yml 配置三、代码案例1. 控制器注入 ImageModel三种接口2.可选图片未完成时的重试Spring AI Alibaba 图像模型实战文生图用 Spring AI Alibaba 接入阿里云百炼 DashScope完成「文字 → 图片」。版本Spring Boot3.4.5spring-ai-alibaba-starter-dashscope1.0.0.4Java17Spring-ai更新速度快,请以官方为准可参考网址:Spring-ai官网Spring-ai阿里巴巴阿里百炼模型广场开发者指南(API/SDK)一、依赖引入!-- Spring Web提供 REST 接口 --dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactId/dependency!-- Spring AI Alibaba自动装配 DashScopeImageModel --dependencygroupIdcom.alibaba.cloud.ai/groupIdartifactIdspring-ai-alibaba-starter-dashscope/artifactIdversion1.0.0.4/version/dependency!-- 官方 DashScope SDK部分场景会用到 --dependencygroupIdcom.alibaba/groupIdartifactIddashscope-sdk-java/artifactIdversion2.22.18/version/dependency二、yml 配置# 复制为 application.yaml密钥用环境变量不要写死在仓库里spring:application:name:spring-image-demoai:dashscope:# IDEA Run Configuration → EnvironmentDASHSCOPE_API_KEYsk-xxxapi-key:${DASHSCOPE_API_KEY}image:options:# DashScopeImageModel 兼容的万相文生图模型# 不要用 qwen-image-* 等多模态同步模型会报 url error / 400model:wanx2.1-t2i-turbo启动前设置环境变量$env:DASHSCOPE_API_KEY你的百炼API Key三、代码案例1. 控制器注入 ImageModel三种接口RestControllerRequestMapping(/example)publicclassDashScopeImageController{/** 由 starter 自动配置注入底层是 DashScopeImageModel */privatefinalImageModelimageModel;privatestaticfinalStringDEFAULT_PROMPT为人工智能生成一张富有科技感的图片;publicDashScopeImageController(ImageModelimageModel){this.imageModelimageModel;}/** * 最简文生图用默认 prompt 生成一张图把远端 URL 的字节写回浏览器。 * GET /example/image */GetMapping(/image)publicvoidimage(HttpServletResponseresponse){// 1构造 ImagePrompt只有提示词模型走 yml 默认配置ImageResponseimageResponseimageModel.call(newImagePrompt(DEFAULT_PROMPT));// 2异步任务完成后结果里一般是临时图片 URLStringimageUrlimageResponse.getResult().getOutput().getUrl();try{// 3服务端打开 URL把 PNG 字节写给前端浏览器直接显示图片URLurlURI.create(imageUrl).toURL();InputStreaminurl.openStream();response.setHeader(Content-Type,MediaType.IMAGE_PNG_VALUE);response.getOutputStream().write(in.readAllBytes());response.getOutputStream().flush();}catch(IOExceptione){response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);}}/** * 同一 prompt 生成多张图返回 URL 集合。 * GET /example/image/multiPrompt?prompt一只会编程的猫count2 */GetMapping(/image/multiPrompt)publicResponseEntityCollectionStringgenerateImageWithMultiPrompt(RequestParam(valueprompt,defaultValue一只会编程的猫)Stringprompt,RequestParam(defaultValue2)intcount){// N一次要几张图ImageOptionsoptionsImageOptionsBuilder.builder().N(count).build();ImageResponseresponseimageModel.call(newImagePrompt(prompt,options));// 每张结果取 URL收集成 SetSetStringimageSetresponse.getResults().stream().map(result-result.getOutput().getUrl()).collect(Collectors.toSet());returnResponseEntity.ok(imageSet);}/** * 多条件拼 prompt 宽高。 * GET /example/image/multipleConditions?subject猫environment办公室style生动 */GetMapping(/image/multipleConditions)publicResponseEntity?multipleConditions(RequestParam(valuesubject,defaultValue一只会编程的猫)Stringsubject,RequestParam(valueenvironment,defaultValue办公室)Stringenvironment,RequestParam(valueheight,defaultValue1024)Integerheight,RequestParam(valuewidth,defaultValue1024)Integerwidth,RequestParam(valuestyle,defaultValue生动)Stringstyle){// 把多个参数拼成一句完整提示词StringpromptString.format(一个%s置身于%s的环境中使用%s的艺术风格高清4K画质细节精致,subject,environment,style);ImageOptionsoptionsImageOptionsBuilder.builder().height(height).width(width).build();try{ImageResponseresponseimageModel.call(newImagePrompt(prompt,options));// 成功时直接返回图片 URL 字符串returnResponseEntity.ok(response.getResult().getOutput().getUrl());}catch(Exceptione){// 失败时返回 JSON 错误信息避免空白 500returnResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(Map.of(error,图像生成失败,message,e.getMessage(),timestamp,LocalDateTime.now()));}}}2.可选图片未完成时的重试万相文生图是异步任务。旧版在 pending 时可能抛RuntimeException默认 Retry 可能不够。可提供自定义RetryTemplateConfigurationpublicclassImageRetryConfig{BeanPrimaryRetryTemplateimageRetryTemplate(){returnRetryTemplate.builder().maxAttempts(30)// 最多重试次数// 初始间隔 2s倍率 1.5上限 15s.exponentialBackoff(Duration.ofSeconds(2),1.5,Duration.ofSeconds(15)).retryOn(RuntimeException.class).build();}}注意HTTP 401Key 无效、400参数错误属于不可恢复错误靠加长重试解决不了。