如何在Java 8项目中实现Azure OpenAI？spring-snapshot适配问题求解

可以在Java 8项目中集成Azure OpenAI功能，无需依赖仅支持Java 17的spring-snapshot库，直接通过调用Azure OpenAI的REST API即可实现。以下是具体实现步骤：

1. 获取Azure OpenAI凭据 #

从Azure门户中获取你的Azure OpenAI资源的API密钥和端点地址，不同功能（如聊天补全、图片生成）对应不同的端点路径，可参考官方API定义确认参数格式。

2. 选择HTTP客户端实现调用 #

Java 8支持原生HttpsURLConnection，也可以使用兼容Java 8的第三方HTTP库（如Apache HttpClient）。以下是两种实现示例：

示例1：使用Apache HttpClient（推荐） #

首先在Maven中添加兼容Java 8的依赖：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.14</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.4.2</version>
</dependency>

然后编写调用代码（以DALL-E图片生成为例）：

import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.HashMap;
import java.util.Map;

public class AzureOpenAIClient {
    public static void generateImage() throws Exception {
        String apiKey = "你的Azure OpenAI API密钥";
        String endpoint = "你的Azure OpenAI图片生成端点";

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpPost httpPost = new HttpPost(endpoint);
            // 设置请求头
            httpPost.setHeader("Content-Type", "application/json");
            httpPost.setHeader("api-key", apiKey);

            // 构建请求体
            Map<String, Object> requestBody = new HashMap<>();
            requestBody.put("prompt", "一只在海边晒太阳的橘猫");
            requestBody.put("size", "1024x1024");
            requestBody.put("n", 1);

            ObjectMapper objectMapper = new ObjectMapper();
            String jsonBody = objectMapper.writeValueAsString(requestBody);
            httpPost.setEntity(new StringEntity(jsonBody));

            // 发送请求并处理响应
            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                HttpEntity entity = response.getEntity();
                if (entity != null) {
                    String responseStr = EntityUtils.toString(entity);
                    // 解析响应，提取图片URL等信息
                    Map<String, Object> responseMap = objectMapper.readValue(responseStr, Map.class);
                    System.out.println("生成的图片URL：" + ((Map)responseMap.get("data")).get("url"));
                }
            }
        }
    }

    public static void main(String[] args) throws Exception {
        generateImage();
    }
}

示例2：使用Java 8原生HttpsURLConnection #

无需额外依赖，直接使用JDK自带类实现：

import javax.net.ssl.HttpsURLConnection;
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.URL;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.HashMap;
import java.util.Map;

public class AzureOpenAINativeClient {
    public static void generateImage() throws Exception {
        String apiKey = "你的Azure OpenAI API密钥";
        String endpoint = "你的Azure OpenAI图片生成端点";

        URL url = new URL(endpoint);
        HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();

        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/json");
        conn.setRequestProperty("api-key", apiKey);
        conn.setDoOutput(true);

        // 构建请求体
        Map<String, Object> requestBody = new HashMap<>();
        requestBody.put("prompt", "一只在海边晒太阳的橘猫");
        requestBody.put("size", "1024x1024");
        requestBody.put("n", 1);

        ObjectMapper objectMapper = new ObjectMapper();
        String jsonBody = objectMapper.writeValueAsString(requestBody);

        try (DataOutputStream wr = new DataOutputStream(conn.getOutputStream())) {
            wr.writeBytes(jsonBody);
            wr.flush();
        }

        // 读取响应
        BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String inputLine;
        StringBuilder response = new StringBuilder();

        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();

        // 解析响应
        Map<String, Object> responseMap = objectMapper.readValue(response.toString(), Map.class);
        System.out.println("生成的图片URL：" + ((Map)responseMap.get("data")).get("url"));
    }

    public static void main(String[] args) throws Exception {
        generateImage();
    }
}

3. 关键注意事项 #

• 所有依赖库必须选择兼容Java 8的版本，避免引入要求Java 11及以上的包。
• 处理API调用的异常场景，包括网络超时、权限错误（401）、请求超限（429）等，添加重试或错误处理逻辑。
• 根据实际使用的Azure OpenAI功能（如GPT聊天补全）调整请求端点、请求体参数和响应解析逻辑。

内容的提问来源于stack exchange，提问作者Andy Wood