Spring AI：接入云百炼之【文生视频】

1、文生视频简介

文生视频，顾名思义就是，根据文本信息生成一个视频。目前（截至2025-11-14），云百炼可供选择的模型有4个，除了模型wan2.5-t2v-preview支持音频能力外，其他3个都是无声视频。

1.1、避坑指南

计费规则是按成功生成的视频秒数计费的，失败不计费也不占用免费额度。视频的费用比文生图、语音生成和语音识别的都贵，而且免费额度也是很低的，区间在50~200秒。

免费额度一旦用完就开始计费了，为避免产生额外费用，可开启免费额度用完即停开关，详细操作请参考官方文档。

2、文生视频代码实现

2.1、前提条件

文生视频模型调用是基于SDK实现，因此需要引入DashScope SDK的pom依赖：

<!-- 云百炼 Java SDK --><dependency><groupId>com.alibaba</groupId><artifactId>dashscope-sdk-java</artifactId><!-- 最新版本号查询：https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java --><version>最新版本号</version></dependency>

2.2、代码实现（有声音频）

Java SDK 调用有两种方式：同步和异步，本文提供同步的示例代码，在官方文档提供的基础做一些调整。

实现步骤大致如下：

使用VideoSynthesisParam类构造语音生成的参数，
调用VideoSynthesis类的call()方法，获取生成视频URL，
根据视频URL，下载保存到本地文件。

创建一个测试类：AIVideoController，添加方法：genSync()，以模型wan2.5-t2v-preview为例，参考代码如下：

/*** 文生视频-同步调用* @param msg 用户提示信息* @return*/@RequestMapping(value="/genSync" )publicStringgenSync(@RequestParam(value="msg", defaultValue="一只老鹰在空中飞翔，地上有两个小孩在朝着空中看，兴奋地喊着：看，有一只老鹰") Stringmsg) {VideoSynthesisvs=newVideoSynthesis();VideoSynthesisParamparam=VideoSynthesisParam.builder()        .apiKey(API_KEY)               .model("wan2.5-t2v-preview")               .prompt(msg)// 自动生成语音        .audio(true)        .size("832*480")        .promptExtend(false)// 是否添加水印标识，水印位于视频右下角，文案固定为“AI生成”。默认值 false        .watermark(true)// 随机数种子，取值范围为[0, 2147483647]。//未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。//请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。        .seed(12345)        .build();System.out.println("视频生成中，请稍候...");VideoSynthesisResultresult=null;try {result=vs.call(param);    } catch (Exceptione) {System.out.println("n视频发生异常: ");e.printStackTrace();                } System.out.println(JsonUtils.toJson(result));StringvideoUrl=result.getOutput().getVideoUrl();System.out.println("生成的视频Url: "+videoUrl);try {// 下载视频文件到本地if (videoUrl!=null) {InputStreaminputStream=newURL(videoUrl).openStream();StringfilePath=System.getProperty("user.dir") +"/video-20251114-1.mp4";FileOutputStreamoutputStream=newFileOutputStream(filePath);byte[] bytes=newbyte[1024];intbytesRead;while ((bytesRead=inputStream.read(bytes)) !=-1) {outputStream.write(bytes, 0, bytesRead);            }System.out.println("n视频文件已下载到本地："+filePath);        }    } catch (IOExceptione) {System.out.println("n下载视频文件时出错: ");e.printStackTrace();    }returnvideoUrl;}