火山引擎怎么用Java调用模型_火山引擎Java接口调用教程

梦芳酱_7921

梦芳酱_7921

2026-11-17

457人浏览

原创

必须完成鉴权配置、依赖引入、服务构建和请求封装四步,否则返回401或403错误;需引入volcengine-ark-java-sdk≥1.2.5版本,配置ARK专用API Key,构建ArkService并正确使用ChatCompletionRequest发送流式或非流式请求。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

火山引擎怎么用java调用模型_火山引擎java接口调用教程

要在Java项目中调用火山引擎的AI模型(如DeepSeek、豆包等),必须完成鉴权配置、依赖引入、服务构建和请求封装四步,缺一不可,否则会直接返回401或403错误。

引入SDK依赖

在pom.xml中添加最新版volcengine-ark-java-sdk依赖:


  com.volcengine
  volcengine-ark-java-sdk
  1.2.8

注意:版本号必须≥1.2.5,低版本不支持ChatCompletionRequest结构化请求;若Maven仓库未同步,需手动下载JAR并install到本地仓库。

配置API Key与模型参数

方法一:硬编码方式(仅限开发测试)

声明静态常量:
private static final String API_KEY = "ak-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
private static final String MODEL_NAME = "doubao-pro-32k-241215";

【API_KEY必须是火山控制台「ARK」服务下生成的密钥,不是通用AK/SK】。在https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey页面创建,复制时勿带空格或换行。

方法二:环境变量注入(推荐线上使用)

火山引擎
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

启动JVM时添加:
-Dvolc.ark.api.key=${YOUR_API_KEY}

代码中读取:
String apiKey = System.getProperty("volc.ark.api.key");
if (apiKey == null || apiKey.trim().isEmpty()) { throw new IllegalStateException("API Key not set via -Dvolc.ark.api.key"); }

构建ArkService并发送流式请求

第一步:初始化服务客户端
ArkService service = ArkService.builder().apiKey(API_KEY).build();

第二步:组装系统提示与用户消息
List messages = new ArrayList();
messages.add(ChatMessage.builder().role(ChatMessageRole.SYSTEM).content("你是一个英语教学助手").build());
messages.add(ChatMessage.builder().role(ChatMessageRole.USER).content("生成一篇关于环保的短文,200词以内").build());

第三步:构造请求对象并调用
ChatCompletionRequest request = ChatCompletionRequest.builder()
  .model(MODEL_NAME)
  .messages(messages)
  .stream(true) // 开启流式响应
  .maxTokens(512)
  .temperature(0.7)
  .build();

第四步:执行请求并消费响应流
service.createChatCompletion(request).forEach(chunk -> {
  System.out.print(chunk.getChoices().get(0).getDelta().getContent());
});

这一步操作起来很简单,直接把request传进去就行。但要注意:如果stream(false),则返回完整JSON响应体,需手动解析choices[0].message.content字段;流式模式下每个chunk只含增量文本,不可直接当完整结果用。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12777

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9862

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8372

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1596

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3349

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20571

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1455

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习