Spring AI Alibaba文生图实战：从零开始编写AI图片生成Demo

程序员小赵同学2025-11-12 15:09

文章目录

  • [Spring AI Alibaba文生图实战：从零开始编写AI图片生成Demo](#Spring AI Alibaba文生图实战：从零开始编写AI图片生成Demo)

Spring AI Alibaba文生图实战：从零开始编写AI图片生成Demo

本文面向初学Spring AI Alibaba的开发者，手把手教你实现文生图功能。

本文将详细介绍如何使用 Spring AI Alibaba 框架快速集成阿里云百炼大模型服务，实现文生图（Text-to-Image）功能。通过本教程，你将学会创建一个简单的Spring Boot应用，只需几行代码就能让AI根据你的文字描述生成图片。

一、什么是文生图？

文生图是指通过文字描述生成对应图像的技术。在没有AI之前，要获得符合自己想法的图片通常需要自己绘制（需要美术功底）、拍照或付费请专业人士制作。而现在，借助AI大模型，我们只需将想法（提示词）告诉AI，程序就能生成相应的图片。

二、环境准备

1. 环境要求

在开始之前，请确保你的开发环境满足以下要求：

  • JDK 17及以上（本文使用JDK 17）
  • Spring Boot 3.x及以上（本文使用Spring Boot 3.5.7）
  • Maven 3.6及以上

2. 获取API Key

  1. 访问阿里云百炼平台并登录你的账号
  2. 开通"百炼大模型"服务（新用户通常有一定免费额度）
  3. 在控制台中生成API Key并保存

使用某个模型时，建议开启该模型的"免费额度用完即停"功能，防止测试中超额扣费。

三、创建Spring Boot项目

1. 初始化项目

访问 start.spring.io 快速创建项目，配置如下：

  • Project: Maven
  • Language: Java
  • Spring Boot: 3.5.7
  • Group: com.example
  • Artifact: spring-ai-demo
  • Java: 17
  • Dependencies: Spring Web

点击"Generate"下载项目压缩包并解压到本地。

2. 配置pom.xml

在pom.xml中添加Spring AI Alibaba依赖和仓库配置：

xml 复制代码 
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.5.7</version>
        <relativePath/>
    </parent>
    
    <groupId>com.example</groupId>
    <artifactId>spring-ai-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>spring-ai-demo</name>
    
    <properties>
        <java.version>17</java.version>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        
        <dependency>
            <groupId>com.alibaba.cloud.ai</groupId>
            <artifactId>spring-ai-alibaba-starter</artifactId>
            <version>1.0.0-M5.1</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <!-- 添加Spring Milestones仓库 -->
    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>
</project>

由于Spring AI相关依赖尚未发布到中央仓库，所以需要添加Spring Milestones仓库。

四、配置应用参数

  • 这里的API_KEY是上面获取的阿里云百炼的key

1. 配置API Key

在src/main/resources/application.yml中添加配置：

yaml 复制代码 
spring:
  application:
    name: spring-ai-demo
  ai:
    dashscope:
      api-key: ${AI_DASHSCOPE_API_KEY}
      image:
        options:
          model: qwen-image-edit-plus

安全提示：不建议将API Key直接写在代码中，可以通过环境变量设置：

Windows系统：

cmd 复制代码 
set AI_DASHSCOPE_API_KEY=你的API_KEY

Mac/Linux系统：

bash 复制代码 
export AI_DASHSCOPE_API_KEY=你的API_KEY

2. 可选模型配置

Spring AI Alibaba支持多种文生图模型，初期可免费使用，可以在配置文件中指定：

yaml 复制代码 
spring:
  ai:
    dashscope:
      api-key: ${AI_DASHSCOPE_API_KEY}
      image:
        options:
          model: wan2.5-t2i-preview  # 可选模型

常用模型有：

  • wan2.5-i2i-preview
  • qwen-image-edit-plus
  • wan2.5-t2i-preview

五、实现文生图接口

1. 创建ImageController

创建ImageController.java文件，实现文生图功能：

java 复制代码 
package com.example.spring_ai_demo.controller;

import org.springframework.ai.image.ImageModel;
import org.springframework.ai.image.ImagePrompt;
import org.springframework.ai.image.ImageResponse;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/ai")
public class ImageController {
    
    private final ImageModel imageModel;

    public ImageController(ImageModel imageModel) {
        this.imageModel = imageModel;
    }

    @GetMapping("/image")
    public String generateImage(@RequestParam(value = "input", defaultValue = "一只在草地上玩耍的可爱小猫") String input) {
        ImagePrompt imagePrompt = new ImagePrompt(input);
        ImageResponse response = imageModel.call(imagePrompt);
        String imageUrl = response.getResult().getOutput().getUrl();
        
        return "redirect:" + imageUrl;
    }
}

2. 进阶版本：支持自定义参数

如需更多控制，可以使用ImageOptions自定义参数：

java 复制代码 
package com.example.spring_ai_demo.controller;

import org.springframework.ai.image.ImageModel;
import org.springframework.ai.image.ImagePrompt;
import org.springframework.ai.image.ImageResponse;
import org.springframework.ai.image.ImageOptionsBuilder;
import org.springframework.ai.image.ImageOptions;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/ai")
public class ImageModelController {
    
    private final ImageModel imageModel;

    public ImageModelController(ImageModel imageModel) {
        this.imageModel = imageModel;
    }

    @GetMapping("/image/advanced")
    public String generateImageAdvanced(
            @RequestParam String input,
            @RequestParam(defaultValue = "wan2.5-t2i-preview") String model,
            @RequestParam(defaultValue = "1024") int width,
            @RequestParam(defaultValue = "1024") int height) {
        
        ImageOptions options = ImageOptionsBuilder.builder()
                .model(model)
                .width(width)
                .height(height)
                .build();

        ImagePrompt imagePrompt = new ImagePrompt(input, options);
        ImageResponse response = imageModel.call(imagePrompt);
        String imageUrl = response.getResult().getOutput().getUrl();
        
        return "生成的图片URL: " + imageUrl + "<br><img src='" + imageUrl + "' alt='生成的图片'>";
    }
}

3. 直接返回图片的接口

如果需要直接返回图片数据，可以使用以下实现：

java 复制代码 
@GetMapping("/image/direct")
public void generateImageDirect(
        @RequestParam String input, 
        HttpServletResponse response) throws IOException {
    
    ImageResponse imageResponse = imageModel.call(new ImagePrompt(input));
    String imageUrl = imageResponse.getResult().getOutput().getUrl();
    
    try (InputStream in = URI.create(imageUrl).toURL().openStream()) {
        response.setHeader("Content-Type", "image/png");
        response.getOutputStream().write(in.readAllBytes());
        response.getOutputStream().flush();
    }
}

完整ImageController代码

java 复制代码 
package com.example.spring_ai_demo.controller;

import jakarta.servlet.http.HttpServletResponse;
import org.springframework.ai.image.*;
import org.springframework.web.bind.annotation.*;

import java.io.IOException;
import java.io.InputStream;
import java.net.URI;

@RestController
@RequestMapping("/ai")
public class ImageController {

    private final ImageModel imageModel;

    public ImageController(ImageModel imageModel) {
        this.imageModel = imageModel;
    }

    @GetMapping("/image")
    public String generateImage(@RequestParam(value = "input", defaultValue = "一只在草地上玩耍的可爱小猫") String input) {
        ImagePrompt imagePrompt = new ImagePrompt(input);
        ImageResponse response = imageModel.call(imagePrompt);
        String imageUrl = response.getResult().getOutput().getUrl();

        return "redirect:" + imageUrl;
    }

    @GetMapping("/image/advanced")
    public String generateImageAdvanced(
            @RequestParam String input,
            @RequestParam(defaultValue = "wan2.5-t2i-preview") String model,
            @RequestParam(defaultValue = "1024") int width,
            @RequestParam(defaultValue = "1024") int height) {

        ImageOptions options = ImageOptionsBuilder.builder()
                .model(model)
                .width(width)
                .height(height)
                .build();

        ImagePrompt imagePrompt = new ImagePrompt(input, options);
        ImageResponse response = imageModel.call(imagePrompt);
        String imageUrl = response.getResult().getOutput().getUrl();

        return "生成的图片URL: " + imageUrl + "<br><img src='" + imageUrl + "' alt='生成的图片'>";
    }

    @GetMapping("/image/direct")
    public void generateImageDirect(
            @RequestParam String input,
            HttpServletResponse response) throws IOException {

        ImageResponse imageResponse = imageModel.call(new ImagePrompt(input));
        String imageUrl = imageResponse.getResult().getOutput().getUrl();

        try (InputStream in = URI.create(imageUrl).toURL().openStream()) {
            response.setHeader("Content-Type", "image/png");
            response.getOutputStream().write(in.readAllBytes());
            response.getOutputStream().flush();
        }
    }
}

六、创建应用启动类

确保在项目中有Spring Boot启动类：

java 复制代码 
package com.example.spring_ai_demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SpringAiDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringAiDemoApplication.class, args);
        System.out.println("============== Spring AI Demo启动成功 ==============");
        System.out.println("============== 文生图测试地址: http://localhost:8080/ai/image?input=你的提示词 ==============");
    }
}

七、运行和测试

1. 启动应用

直接在IDE中运行SpringAiDemoApplication类。

2. 测试文生图功能

由于大模型生产需要时间，所以接口返回时间较长，调用接口后请耐心等待！！！

打开浏览器，访问以下地址进行测试：

复制代码 
http://localhost:8080/ai/image?input=一只在太空站穿宇航服的猫

调用效果如下：
或者使用自定义参数版本：

复制代码 
http://localhost:8080/ai/image/advanced?input=冬天的梅花&model=wan2.5-t2i-preview&width=1024&height=1024

调用效果如下：

3. 提示词技巧

为了提高生成图片的质量，可以尝试以下提示词技巧：

  • 具体描述："一只在草地上玩耍的橘色小猫，阳光明媚，背景有花朵"
  • 风格指定："水彩画风格，一座被樱花环绕的日本传统寺庙"
  • 细节描述："富有科技感的未来城市，飞行汽车，霓虹灯光，赛博朋克风格"

八、常见问题及解决方案

1. 依赖解析失败

如果出现依赖解析错误，请确保：

  • 已正确配置Spring Milestones仓库
  • 使用的是推荐的Spring Boot和JDK版本

2. API Key错误

如果遇到认证错误：

  • 检查API Key是否正确设置
  • 确认百炼大模型服务已开通
  • 验证API Key是否有足够的余额或免费额度

3. 生成时间较长

文生图功能可能需要一定时间（通常30-70秒），这是正常现象。

4. 同步与异步调用

本文示例使用的是同步调用方式，Spring AI Alibaba也支持异步调用，适合生成时间较长的场景。

九、核心原理简介

Spring AI Alibaba通过以下组件实现文生图功能：

  1. ImageModel：抽象的图像生成模型接口
  2. ImagePrompt：封装输入提示词和参数
  3. ImageResponse：包含生成结果的响应

框架自动装配了与阿里云百炼服务通信的组件，开发者只需关注业务逻辑。

十、总结

通过本教程，你已成功实现了：

  • ✅ 创建Spring Boot项目并集成Spring AI Alibaba
  • ✅ 配置阿里云百炼大模型服务
  • ✅ 实现文生图接口
  • ✅ 通过HTTP API生成图片

完整项目结构：

复制代码 
spring-ai-demo
├── src/main/java
│   └── com/example/spring_ai_demo
│       ├── controller
│       │   └── ImageController.java
│       └── SpringAiDemoApplication.java
├── src/main/resources
│   └── application.yml
└── pom.xml

现在你可以继续探索Spring AI的更多功能，如文本生成、语音合成等多模态AI能力。尝试不同的提示词，发挥创造力，让你的应用更具智能化！

参考资源：

希望本教程对你有所帮助，如有问题欢迎在评论区讨论！

相关推荐
哥布林学者6 小时前
吴恩达深度学习课程二： 改善深层神经网络 第二周：优化算法（五）Adam 优化算法
深度学习·ai
hxj..7 小时前
如何进行AI作图（架构图，流程图等）
人工智能·ai·ai作画
todoitbo7 小时前
使用n8n搭建服务器监控系统：从Webhook到Telegram告警的完整实现
运维·服务器·数据库·ai·向量数据库·流处理·n8n
zz-zjx7 小时前
云计算产品-介绍--计算篇
阿里云·云计算
CoderJia程序员甲7 小时前
GitHub 热榜项目 - 日榜(2025-11-11)
ai·开源·大模型·github·ai教程
Learn Beyond Limits9 小时前
Clustering vs Classification｜聚类vs分类
人工智能·算法·机器学习·ai·分类·数据挖掘·聚类
Less^_^9 小时前
使用 Node.js 开发 Telegram Bot 完整指南
ai·node.js
Sanlings10 小时前
ComfyUI+RX5700XT+Ubuntu25.04运行配置
pytorch·ai·comfyui·amd·rocm·rx5700xt·ubuntu25.04
热门推荐
01GitHub 镜像站点02UV安装并设置国内源03综合整理：pdf预览显示：你尝试预览的文件可能对你的计算机有害。如果你信任此文件以及其来源，请打开此文件以看其内容，如何解决以正常预览文件04Linux下V2Ray安装配置指南05安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）06Labelme从安装到标注：零基础完整指南07BongoCat - 跨平台键盘猫动画工具08《大数据技术原理与应用》实验报告三 熟悉HBase常用操作09看了下昨日泄露的苹果 App Store 源码……10智能库存管理的需求预测模型：从业务痛点到落地代码的完整实践