<!-- https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dashscope-sdk-java</artifactId>
    <version>2.19.1</version>
</dependency>

public interface TestApiKey {
    // 請(qǐng)將下方的 "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 替換為您的真實(shí)有效 API Key
    String API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; 
}

// 建議 DashScope SDK 版本 >= 2.12.0
// 導(dǎo)入所需的Java標(biāo)準(zhǔn)庫(kù)類
import java.util.Arrays;
import java.lang.System;

// 導(dǎo)入阿里云靈積 DashScope SDK 相關(guān)類
import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;

/**
 * 阿里云靈積 AI SDK 調(diào)用示例。
 * <p>
 * 本類演示了如何使用 DashScope SDK 調(diào)用阿里云靈積大模型進(jìn)行對(duì)話，
 * 包括消息構(gòu)建、參數(shù)設(shè)置、API 調(diào)用及異常處理。
 */
public class SdkAiInvoke {
    /**
     * 調(diào)用阿里云靈積大模型生成接口，傳入對(duì)話消息，并返回生成結(jié)果。
     *
     * @return GenerationResult 生成結(jié)果對(duì)象，包含模型回復(fù)等信息。
     * @throws ApiException           API 調(diào)用異常。
     * @throws NoApiKeyException      未配置 API Key 異常。
     * @throws InputRequiredException 輸入?yún)?shù)缺失異常。
     */
    public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
        // 創(chuàng)建 Generation 實(shí)例，用于發(fā)起生成請(qǐng)求
        Generation gen = new Generation();

        // 構(gòu)建系統(tǒng)消息，設(shè)定 AI 助手的角色和行為
        // Role.SYSTEM 代表系統(tǒng)角色，用于設(shè)定 AI 的行為或身份。
        // content 字段為系統(tǒng)提示內(nèi)容，用以指導(dǎo) AI 如何回復(fù)。
        Message systemMsg = Message.builder()
                .role(Role.SYSTEM.getValue())
                .content("You are a helpful assistant.")
                .build();

        // 構(gòu)建用戶消息，模擬用戶輸入
        // Role.USER 代表用戶角色，content 字段為用戶輸入內(nèi)容。
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("你是誰(shuí)？")
                .build();

        // 構(gòu)建生成參數(shù)，包括 API Key、模型名稱、消息列表、返回格式等
        // GenerationParam 用于封裝所有請(qǐng)求參數(shù)。
        GenerationParam param = GenerationParam.builder()
                // 設(shè)置 API Key。TestApiKey.API_KEY 從接口獲取。
                // 生產(chǎn)環(huán)境建議通過(guò)環(huán)境變量配置，或直接使用 .apiKey("sk-您的真實(shí)APIKey") 替換此行。
                .apiKey(TestApiKey.API_KEY) 
                // 此處以qwen-plus為例，可按需更換模型名稱。模型列表：https://help.aliyun.com/zh/model-studio/getting-started/models
                .model("qwen-plus")
                // .messages() 傳入對(duì)話消息列表，通常順序?yàn)橄到y(tǒng)消息、用戶消息。
                .messages(Arrays.asList(systemMsg, userMsg))
                // .resultFormat() 設(shè)置返回結(jié)果的格式為消息格式。
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .build();

        // 調(diào)用生成接口，獲取模型回復(fù)
        // gen.call(param) 方法向阿里云靈積大模型服務(wù)發(fā)起請(qǐng)求。
        // 返回 GenerationResult 對(duì)象，其中包含模型回復(fù)、Token 用量等信息。
        return gen.call(param);
    }

    /**
     * 主方法，程序入口。
     *
     * @param args 命令行參數(shù)
     */
    public static void main(String[] args) {
        try {
            // 調(diào)用 callWithMessage() 方法，獲取 AI 回復(fù)結(jié)果。
            // GenerationResult 對(duì)象中包含了模型回復(fù)內(nèi)容、Token 用量等詳細(xì)信息。
            GenerationResult result = callWithMessage();

            // 將結(jié)果對(duì)象轉(zhuǎn)為 JSON 字符串并打印
            // JsonUtils.toJson(result) 方法將 Java 對(duì)象序列化為 JSON 字符串，方便查看完整的響應(yīng)結(jié)構(gòu)。
            System.out.println(JsonUtils.toJson(result));

            // 示例輸出結(jié)構(gòu)如下（已注釋）：
            // {
            //     "requestId": "...", // 請(qǐng)求唯一標(biāo)識(shí)
            //     "usage": {
            //         "input_tokens": ..., // 輸入token數(shù)
            //         "output_tokens": ..., // 輸出token數(shù)
            //         "total_tokens": ...  // 總token數(shù)
            //     },
            //     "output": {
            //         "choices": [
            //             {
            //                 "finish_reason": "stop", // 結(jié)束原因
            //                 "message": {
            //                     "role": "assistant", // 回復(fù)角色
            //                     "content": "..."      // AI回復(fù)內(nèi)容
            //                 }
            //             }
            //         ]
            //     }
            // }
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            // 捕獲并處理調(diào)用生成服務(wù)時(shí)可能發(fā)生的異常。
            // ApiException：API 調(diào)用異常，可能由網(wǎng)絡(luò)問(wèn)題、服務(wù)端錯(cuò)誤等引起。
            // NoApiKeyException：未配置 API Key 時(shí)拋出的異常。
            // InputRequiredException：必要輸入?yún)?shù)缺失時(shí)拋出的異常。
            // 此處直接打印到標(biāo)準(zhǔn)錯(cuò)誤輸出。在實(shí)際項(xiàng)目中，建議使用日志框架記錄異常，以便追蹤和排查問(wèn)題。
            System.err.println("調(diào)用生成服務(wù)時(shí)發(fā)生錯(cuò)誤: " + e.getMessage());
        }
        // 程序執(zhí)行完畢，正常退出。
        System.exit(0);
    }
}

將上述請(qǐng)求轉(zhuǎn)換為 Hutool 工具類的請(qǐng)求代碼

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONObject;

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

/**
 * 本類演示了如何通過(guò) HTTP 請(qǐng)求調(diào)用阿里云通義千問(wèn)大模型接口進(jìn)行文本生成，
 * 并使用 Hutool 工具庫(kù)簡(jiǎn)化 HTTP 請(qǐng)求和 JSON 構(gòu)建。
 */
public class HttpAiInvoke {
    public static void main(String[] args) {
        // 定義接口請(qǐng)求的 URL，替換為實(shí)際的 API 地址
        String url = "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation";

        // 創(chuàng)建請(qǐng)求頭的 Map，用于存放 HTTP 請(qǐng)求頭信息
        Map<String, String> headers = new HashMap<>();
        // 設(shè)置 Authorization 頭，使用 Bearer 方式攜帶 API 密鑰
        headers.put("Authorization", "Bearer " + TestApiKey.API_KEY);
        // 設(shè)置 Content-Type 頭，指定請(qǐng)求體為 JSON 格式
        headers.put("Content-Type", "application/json");

        // 構(gòu)建請(qǐng)求體的 JSON 對(duì)象
        JSONObject requestBody = new JSONObject();
        // 指定使用的模型名稱
        requestBody.put("model", "qwen-plus");

        // 創(chuàng)建 input 字段的 JSON 對(duì)象
        JSONObject input = new JSONObject();
        // 創(chuàng)建消息數(shù)組，包含 system 和 user 兩種角色的消息
        JSONObject[] messages = new JSONObject[2];

        // 構(gòu)建 system 消息，指定 AI 助手的身份和行為
        JSONObject systemMessage = new JSONObject();
        systemMessage.put("role", "system");
        systemMessage.put("content", "You are a helpful assistant.");
        messages[0] = systemMessage;

        // 構(gòu)建 user 消息，指定用戶輸入的內(nèi)容
        JSONObject userMessage = new JSONObject();
        userMessage.put("role", "user");
        userMessage.put("content", "你是誰(shuí)？");
        messages[1] = userMessage;

        // 將消息數(shù)組放入 input 對(duì)象
        input.put("messages", messages);
        // 將 input 對(duì)象放入請(qǐng)求體
        requestBody.put("input", input);

        // 構(gòu)建參數(shù)對(duì)象，設(shè)置返回結(jié)果格式為 message
        JSONObject parameters = new JSONObject();
        parameters.put("result_format", "message");
        // 將參數(shù)對(duì)象放入請(qǐng)求體
        requestBody.put("parameters", parameters);

        // 發(fā)送 HTTP POST 請(qǐng)求，攜帶請(qǐng)求頭和請(qǐng)求體
        HttpResponse response = HttpRequest.post(url)
                .addHeaders(headers)
                .body(requestBody.toString())
                .execute();

        // 判斷響應(yīng)是否成功
        if (response.isOk()) {
            // 請(qǐng)求成功時(shí)輸出響應(yīng)內(nèi)容
            System.out.println("請(qǐng)求成功，響應(yīng)內(nèi)容：");
            System.out.println(response.body());
        } else {
            // 請(qǐng)求失敗時(shí)輸出狀態(tài)碼和響應(yīng)內(nèi)容
            System.out.println("請(qǐng)求失敗，狀態(tài)碼：" + response.getStatus());
            System.out.println("響應(yīng)內(nèi)容：" + response.body());
        }
    }
}

<dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter</artifactId>
    <version>1.0.0-M6.1</version>
</dependency>

<repositories>
  <repository>
    <id>spring-milestones</id>
    <name>Spring Milestones</name>
    <url>https://repo.spring.io/milestone</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>

spring:
  application:
    name: spring-ai-alibaba-qwq-chat-client-example
  ai:
    dashscope:
      # 請(qǐng)?zhí)鎿Q為您的 API Key 或通過(guò)環(huán)境變量設(shè)置
      api-key: ${AI_DASHSCOPE_API_KEY}
      chat:
        options:
          model: qwen-plus

import jakarta.annotation.Resource;
import org.springframework.ai.chat.messages.AssistantMessage;
import org.springframework.ai.chat.model.ChatModel;
import org.springframework.ai.chat.prompt.Prompt;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component; // 確保導(dǎo)入 Component 注解

@Component // 將此類聲明為 Spring 組件
public class SpringAiAiInvoke implements CommandLineRunner {

    /**
     * 注入 ChatModel 實(shí)例，代表一個(gè)可用的 AI 聊天模型。
     * 通過(guò) @Resource 注解自動(dòng)裝配，bean 名稱為 dashscopeChatModel。
     */
    @Resource
    private ChatModel dashscopeChatModel;

    /**
     * 應(yīng)用啟動(dòng)時(shí)自動(dòng)調(diào)用的方法。
     * 該方法向 AI 聊天模型發(fā)送問(wèn)候語(yǔ)，并打印 AI 的回復(fù)。
     *
     * @param args 啟動(dòng)參數(shù)
     * @throws Exception 可能拋出的異常
     */
    @Override
    public void run(String... args) throws Exception {
        // 創(chuàng)建一個(gè)新的 Prompt 實(shí)例，內(nèi)容為“你好，我是 NEO”
         Prompt prompt = new Prompt("你好，我是 NEO");

        // 調(diào)用 dashscopeChatModel 的 call 方法，傳入 prompt，獲取 AI 回復(fù)
        AssistantMessage assistantMessage = dashscopeChatModel.call(prompt)
                .getResult() // 獲取調(diào)用結(jié)果對(duì)象
                .getOutput(); // 獲取 AI 輸出的消息對(duì)象

        // 打印 AI 助手的回復(fù)文本到控制臺(tái)
        System.out.println("Assistant Response: " + assistantMessage.getText());
    }
}

<!-- https://mvnrepository.com/artifact/dev.langchain4j/langchain4j-community-dashscope -->
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-community-dashscope</artifactId>
    <version>1.0.0-beta2</version> <!-- 請(qǐng)檢查并使用最新穩(wěn)定版 -->
</dependency>

import dev.langchain4j.community.model.dashscope.QwenChatModel;

public class LangChainAiInvoke {
    /**
     * 程序主入口。
     * 運(yùn)行后會(huì)向 Qwen Max 模型發(fā)送消息，并輸出模型回復(fù)。
     * 
     * @param args 命令行參數(shù)（本示例未使用）
     */
    public static void main(String[] args) {
        // 創(chuàng)建 QwenChatModel 的構(gòu)建器，用于配置模型參數(shù)
        QwenChatModel qwenChatModel = QwenChatModel.builder()
                // 設(shè)置 API Key，用于身份認(rèn)證，必須替換為你自己的有效 Key
                .apiKey(TestApiKey.API_KEY) // 確保 TestApiKey.API_KEY 已正確配置
                // 指定要使用的模型名稱，這里選擇 "qwen-max"
                .modelName("qwen-max") // 可根據(jù)需求選擇其他模型，如 qwen-plus, qwen-turbo 等
                // 構(gòu)建出 QwenChatModel 實(shí)例，后續(xù)可以用它與大模型對(duì)話
                .build();

        // 向 Qwen Max 發(fā)送一條消息，chat 方法會(huì)返回模型的回復(fù)內(nèi)容
        String response = qwenChatModel.chat("你好，Qwen Max！請(qǐng)問(wèn)你能幫我做什么？");

        // 將模型的回答輸出到控制臺(tái)，方便查看結(jié)果
        System.out.println("Qwen Max的回答: " + response);
    }
}