山东大学软件学院项目实训-创新实训-基于大模型的旅游平台汇总（十）

      /**
         获取access_token
       **/
      @PostMapping("/get_token")
      public ResponseEntity<String> getBaiduToken() {
          String authUrl = "https://aip.baidubce.com/oauth/2.0/token";
  
          // Set headers
          HttpHeaders headers = new HttpHeaders();
          headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
  
          MultiValueMap<String, String> map = new LinkedMultiValueMap<>();
          map.add("grant_type", "client_credentials");
          map.add("client_id", apiKey);
          map.add("client_secret", secretKey);
  
          HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(map, headers);
  
          ResponseEntity<Map> response = restTemplate.postForEntity(authUrl, entity, Map.class);
          if (response.getStatusCode() == HttpStatus.OK) {
              Map<String, Object> responseBody = response.getBody();
              if (responseBody != null && responseBody.containsKey("access_token")) {
                  String accessToken = (String) responseBody.get("access_token");
                  return ResponseEntity.ok(accessToken);
              } else {
                  return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("找不到token");
              }
          } else {
              return ResponseEntity.status(response.getStatusCode()).body(response.getBody().toString());
          }
      }

这段代码用于获取百度AI平台的访问令牌（access token）。

public ResponseEntity<String> getBaiduToken() {: 方法的声明，返回一个ResponseEntity，其中包含一个String类型的数据，表示获取到的访问令牌。
String authUrl = "https://aip.baidubce.com/oauth/2.0/token";: 这是百度AI平台用于获取访问令牌的API地址。
HttpHeaders headers = new HttpHeaders();: 创建HTTP请求头对象。
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);: 设置HTTP请求头的内容类型为application/x-www-form-urlencoded，表示表单数据。
MultiValueMap<String, String> map = new LinkedMultiValueMap<>();: 创建一个用于存储请求参数的Map对象，参数是键值对形式。
map.add("grant_type", "client_credentials");: 将客户端凭证模式作为参数添加到请求中。
map.add("client_id", apiKey);: 将API密钥作为参数添加到请求中。
map.add("client_secret", secretKey);: 将密钥作为参数添加到请求中。
HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(map, headers);: 创建一个HTTP实体对象，包含请求参数和请求头信息。
ResponseEntity<Map> response = restTemplate.postForEntity(authUrl, entity, Map.class);: 发送HTTP POST请求到指定的URL，使用之前构建的实体对象，返回一个ResponseEntity，其中包含一个Map对象，表示API的响应。
if (response.getStatusCode() == HttpStatus.OK) {: 检查HTTP响应状态码是否为200（OK）。
Map<String, Object> responseBody = response.getBody();: 获取API响应的主体内容。
if (responseBody != null && responseBody.containsKey("access_token")) {: 检查API响应中是否包含名为"access_token"的字段。
String accessToken = (String) responseBody.get("access_token");: 从API响应中获取访问令牌。
return ResponseEntity.ok(accessToken);: 如果获取到了访问令牌，则以HTTP 200的状态返回访问令牌。
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("找不到token");: 如果无法获取到访问令牌，则返回HTTP 500（Internal Server Error）状态码，并包含一条错误消息。
return ResponseEntity.status(response.getStatusCode()).body(response.getBody().toString());: 如果HTTP响应状态码不是200，则返回与API响应体相同的状态码和内容。

我们可以通过ApiFox来测试接口编写的正确性:

可以看到他成功的返回了我们想要的token，以后请求我们带上他就好。

图像内容理解-提交请求接口

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/image-classify/v1/image-understanding/request

URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token

Header如下：

参数	值
Content-Type	application/json

Body中放置请求参数，要求使用json格式的结构体来描述一个请求的具体内容，参数详情如下：

请求参数

参数	是否必选	类型	可选值范围	说明
image	和 url 二选一	string	-	图片数据，base64 编码后进行 urlencode，要求 base64 编码和 urlencode 后大小不超过 4M，最短边至少 15px，最长边最大 4096px，支持 jpg/jpeg/png/bmp 格式优先级：image > url，当 image 字段存在时，url 字段失效
url	和 image 二选一	string	-	图片完整 url，url 长度不超过 1024 字节，要求 base64 编码和 urlencode 后大小不超过 4M，最短边至少 15px，最长边最大 4096px，支持 jpg/jpeg/png/bmp 格式优先级：image > url，当 image 字段存在时，url 字段失效
question	是	string	-	提问信息，如“这张图片里有什么？”、“这张图片里有几只鸟”限制 100 个字符之内
output_CHN	否	bool	true/false	是否以中文输出描述 description 和拼接语句 description_to_llm ，可选值包括：- true：以中文输出- false：不以中文输出，默认为 false

返回参数

字段	类型	说明
log_id	uint64	唯一的log id，用于问题定位
result	object	返回结果列表
+ task_id	string	该请求生成的task_id，后续使用该task_id获取识别结果

返回示例

  
  {
      "log_id": 1749362025959261144,
      "result":{
          "task_id":"1749357426042159725",
      },
  }

我们可以根据这个请求格式编写提交请求的接口:

  
      /**
       * 图像内容理解-提交请求接口
       */
      @PostMapping("/image-understanding/request")
      public ResponseEntity<String> submitImageUnderstandingRequest(@RequestBody Map<String, Object> request) {
          ResponseEntity<String> tokenResponse = getBaiduToken();
          if (tokenResponse.getStatusCode() != HttpStatus.OK) {
              return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("获取token失败");
          }
          String accessToken = tokenResponse.getBody();
          String requestUrl = "https://aip.baidubce.com/rest/2.0/image-classify/v1/image-understanding/request";
  
          HttpHeaders headers = new HttpHeaders();
          headers.setContentType(MediaType.APPLICATION_JSON);
  
          // 构建请求体，可能包含image或url，以及question
          Map<String, Object> requestBody = new HashMap<>();
          requestBody.put("image", request.get("image")); // base64编码后的图片数据
          requestBody.put("url", request.get("url")); // 或者是图片的URL
          requestBody.put("question", request.get("question")); // 提问信息
  
          HttpEntity<Map<String, Object>> entity = new HttpEntity<>(requestBody, headers);
          ResponseEntity<String> response = restTemplate.postForEntity(requestUrl + "?access_token=" + accessToken, entity, String.class);
  
          return response;
      }

这段代码用于提交图像内容理解的请求到百度AI平台。

@PostMapping("/image-understanding/request"): POST请求的映射，指定了该方法处理的URL路径为"/image-understanding/request"。
public ResponseEntity<String> submitImageUnderstandingRequest(@RequestBody Map<String, Object> request) {: 方法的声明，它接受一个Map<String, Object>类型的请求体，并返回一个ResponseEntity，其中包含一个String类型的数据，表示处理结果。
ResponseEntity<String> tokenResponse = getBaiduToken();: 调用之前定义的getBaiduToken()方法，获取百度AI平台的访问令牌。
if (tokenResponse.getStatusCode() != HttpStatus.OK) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("获取token失败"); }: 检查获取访问令牌的响应状态码是否为200（OK），如果不是，则返回HTTP 500（Internal Server Error）状态码，并包含一条错误消息。
String accessToken = tokenResponse.getBody();: 从获取到的访问令牌响应中提取出访问令牌。
String requestUrl = "https://aip.baidubce.com/rest/2.0/image-classify/v1/image-understanding/request";: 设置图像内容理解请求的URL。
HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON);: 创建HTTP请求头对象，并设置内容类型为JSON。
Map<String, Object> requestBody = new HashMap<>();: 创建一个用于存储请求体参数的Map对象。
requestBody.put("image", request.get("image"));: 将请求中的图像数据放入请求体中。
requestBody.put("url", request.get("url"));: 将请求中的图像URL放入请求体中。
requestBody.put("question", request.get("question"));: 将请求中的提问信息放入请求体中。
HttpEntity<Map<String, Object>> entity = new HttpEntity<>(requestBody, headers);: 创建一个HTTP实体对象，包含请求体和请求头信息。
ResponseEntity<String> response = restTemplate.postForEntity(requestUrl + "?access_token=" + accessToken, entity, String.class);: 发送HTTP POST请求到指定的URL，包括访问令牌作为查询参数，返回一个ResponseEntity，其中包含一个String类型的数据，表示API的响应。
return response;: 返回图像内容理解请求的API响应。

同样的，我们测试该接口：

我们可以看到他成功的获取到了task_id,有了task_id我们就可以用它来获取最终的结果。

图像内容理解-获取结果接口