【新手入门】Java实现文心一言API接入指南

9 0 0

一、API基础概念解析

应用程序接口（API）是不同软件系统之间进行数据交互的标准化协议。它规定了程序组件之间通信的规则和格式，让开发者能够在不了解底层实现的情况下调用外部服务。API通常采用HTTP协议传输数据，并以JSON或XML格式返回响应结果。
我们可以把API比作餐厅的点餐系统：开发者如同顾客，只需通过标准化的菜单（API文档）选择所需功能，而无需关心厨房（服务端）如何烹饪。这种机制极大地简化了开发流程，让开发者能够专注于业务逻辑的实现。

二、文心一言API接入流程

要使用文心一言的智能对话服务，首先需要获取必要的身份凭证。请按照以下步骤操作：
1. 访问百度智能云的千帆大模型平台（https://cloud.baidu.com/product/wenxinworkshop）
2. 使用百度账号登录系统
3. 在平台首页找到”模型广场”入口
千帆大模型平台登录界面
进入模型广场后，您会看到多种AI模型选项。虽然各模型功能不同，但调用方式基本一致。本教程以文心一言为例进行演示。
模型选择界面
创建应用步骤：
1. 点击左侧导航栏的”应用接入”
2. 选择”创建应用”
3. 填写应用名称和描述信息
4. 勾选所有相关服务选项
5. 确认创建
应用创建界面
成功创建应用后，系统会生成专属的API_KEY和SECRET_KEY，这两个密钥是调用API的重要凭证。

三、Java代码实现

下面介绍如何使用Java语言实现API调用：
1. 项目配置
在IntelliJ IDEA中创建Maven项目，并添加以下依赖到pom.xml文件：

<dependencies>
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>4.12.0</version>
</dependency>
<dependency>
<groupId>org.json</groupId>
<artifactId>json</artifactId>
<version>20210307</version>
</dependency>
</dependencies>

核心代码实现

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.io.IOException;
import java.util.concurrent.TimeUnit;
public class WenxinAPI {
// 配置您的API凭证
private static final String API_KEY = "您的API_KEY";
private static final String SECRET_KEY = "您的SECRET_KEY";
// 配置HTTP客户端
private static final OkHttpClient client = new OkHttpClient.Builder()
.readTimeout(30, TimeUnit.SECONDS)
.build();
// 获取访问令牌
private static String getAccessToken() throws IOException {
RequestBody body = RequestBody.create(
"grant_type=client_credentials&client_id=" + API_KEY +
"&client_secret=" + SECRET_KEY,
MediaType.parse("application/x-www-form-urlencoded"));
Request request = new Request.Builder()
.url("https://aip.baidubce.com/oauth/2.0/token")
.post(body)
.build();
try (Response response = client.newCall(request).execute()) {
return new JSONObject(response.body().string()).getString("access_token");
}
}
// 发送对话请求
public static String sendMessage(String userInput) throws IOException {
JSONArray messages = new JSONArray();
JSONObject message = new JSONObject();
message.put("role", "user");
message.put("content", userInput);
messages.put(message);
JSONObject requestBody = new JSONObject();
requestBody.put("messages", messages);
requestBody.put("temperature", 0.95);
requestBody.put("top_p", 0.8);
RequestBody body = RequestBody.create(
requestBody.toString(),
MediaType.parse("application/json"));
Request request = new Request.Builder()
.url("https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token=" + getAccessToken())
.post(body)
.build();
try (Response response = client.newCall(request).execute()) {
return new JSONObject(response.body().string()).getString("result");
}
}
public static void main(String[] args) throws IOException {
System.out.println(sendMessage("你好"));
}
}