上图中可以明显看见通义千问除了有大语言模型，还有通义千问VL和通义千问Audio。因此注意，本文只是针对于通义千问的大语言模型。至于以上两个是做什么的，可自行查看官网。
阿里云官网提供两种提供的快速入门的方法案例：（改进）
在pom.xml文件种导入DashScope SDK的坐标
<!-- 通义千问SDK--><!-- https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java --><dependency> <groupId>com.alibaba</groupId> <artifactId>dashscope-sdk-java</artifactId> <version>2.13.0</version> <exclusions> <exclusion> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> </exclusion> </exclusions></dependency> <dependency> <groupId>com.squareup.okhttp3</groupId> <artifactId>okhttp</artifactId> <version>4.10.0</version> </dependency>
通过messages调用（推荐）
编写Controller层
package com.he.cms.blog.controller;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.he.cms.blog.service.IBlogAiSGenerateService;import io.swagger.annotations.Api;import io.swagger.annotations.ApiOperation;import lombok.extern.slf4j.Slf4j;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.PathVariable;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;/** * @ClassName BlogAiGenerateController * @Author Hym * @Date 2024/4/13 23:01 */@Slf4j@RestController//好好学习，走向巅峰！@Api(tags = "博客生成")public class BlogAiGenerateController { @Autowired private IBlogAiSGenerateService blogAiSGenerateService; /** * 生成博客 */ @RequestMapping("/generateArticle/{content}") @ApiOperation(value = "生成博客", notes = "生成博客" + "调用方式：" + "生成博客" + "传入参数：" + "content") public GenerationResult generateArticle(@PathVariable String content) throws NoApiKeyException, InputRequiredException { GenerationResult generationResult = blogAiSGenerateService.BlogAiSGenerate(content); log.info(generationResult.toString()); return generationResult; }}
2.3 Servic层及实现类
接口
package com.he.cms.blog.service;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;public interface IBlogAiSGenerateService { /** * 生成博客 * * @param title 标题 * @param content 内容 * @return 结果 */ GenerationResult BlogAiSGenerate(String content) throws NoApiKeyException, InputRequiredException;}实现类
package com.he.cms.blog.service.impl;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.he.cms.blog.service.ICmsBlogAiSGenerateService;import com.he.cms.utils.CmsBlogQianWenGenerateUtils;import org.springframework.stereotype.Service;import javax.annotation.Resource;/** * @ClassName BlogAiSGenerateServiceImpl * @Author Hym * @Date 2024/4/13 23:06 */@Service//好好学习，走向巅峰！public class CmsBlogAiSGenerateServiceImpl implements ICmsBlogAiSGenerateService { @Resource private CmsBlogQianWenGenerateUtils cmsBlogQianWenGenerateUtils; @Override public GenerationResult BlogAiSGenerate(String content) throws NoApiKeyException, InputRequiredException { return cmsBlogQianWenGenerateUtils.callWithMessage(content); }// public static void main(String[] args) {// CmsBlogAiSGenerateServiceImpl blogAiSGenerateService = new CmsBlogAiSGenerateServiceImpl();// try {// System.out.println(blogAiSGenerateService.BlogAiSGenerate("给我写一篇java的文章").toString());// } catch (NoApiKeyException e) {// e.printStackTrace();// } catch (InputRequiredException e) {// e.printStackTrace();// }// }}
调用通义千问API的组件
package com.he.cms.utils;import com.alibaba.dashscope.aigc.generation.Generation;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.aigc.generation.models.QwenParam;import com.alibaba.dashscope.common.Message;import com.alibaba.dashscope.common.MessageManager;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.Constants;import io.swagger.annotations.ApiOperation;import lombok.extern.slf4j.Slf4j;import org.springframework.beans.factory.annotation.Value;import org.springframework.stereotype.Component;/** * @ClassName BlogQianWenGenerateUtils * @Author Hym * @Date 2024/4/13 23:13 *///好好学习，走向巅峰！ @Slf4j @Componentpublic class CmsBlogQianWenGenerateUtils { @Value("${tong_yi_cloud.ai_api_Key}") private String qianWenKeyApiKey; @ApiOperation("千问生成文章" + "调用方式：" + "千问生成文章" + "传入参数：" + "content") public GenerationResult callWithMessage(String content) throws NoApiKeyException, ApiException, InputRequiredException { Constants.apiKey=qianWenKeyApiKey; Generation gen = new Generation(); MessageManager msgManager = new MessageManager(10); Message systemMsg = Message.builder().role(Role.SYSTEM.getValue()).content("你是一个写文章的大师").build(); Message userMsg = Message.builder().role(Role.USER.getValue()).content(content).build(); msgManager.add(systemMsg); msgManager.add(userMsg); QwenParam param = QwenParam.builder().model(Generation.Models.QWEN_TURBO).messages(msgManager.get()) .resultFormat(QwenParam.ResultFormat.MESSAGE) .topP(0.8) .enableSearch(true) .build(); GenerationResult result = gen.call(param); log.info("千问api回答的话语为：{}",result); return result; }}
返回结果
{ "requestId": "358d15cd-c01c-9052-aa8f-c20232a50148", "usage": { "inputTokens": 25, "outputTokens": 400, "totalTokens": 425 }, "output": { "text": null, "finishReason": null, "choices": [ { "finishReason": "stop", "index": null, "message": { "role": "assistant", "content": "标题：职场探索：打造个人品牌，成功求职之道\n\n在人生的道路上，找工作如同开启一段新的旅程，充满期待与挑战。在这个竞争激烈的市场中，找到理想的工作不仅需要实力的展现，更需要策略和技巧的巧妙运用。以下是一些关键步骤和建议，助你在求职之路上走得更稳健。\n\n首先，自我认知是基石。明确你的职业目标和兴趣，了解自己的优势与劣势，这将帮助你定位理想的职位。一份精心撰写的简历和个性化的求职信，能精准地传达你的专业技能和独特价值，让招聘者一眼看出你的潜力。\n\n其次，提升自我。不断学习和积累经验是提升竞争力的关键。无论是专业技能的精进，还是软技能的培养，如团队合作、沟通能力等，都能让你在众多应聘者中脱颖而出。参加行业研讨会、实习项目或者志愿者活动，都是拓宽视野和积累实战经验的好方法。\n\n网络的力量不容忽视。利用社交媒体平台如LinkedIn建立专业形象，定期更新你的职业动态和成就，不仅能吸引潜在雇主的注意，也能扩大你的人脉圈。同时，关注行业内的招聘信息，积极投递并参与线上面试，可以提高你的曝光率。\n\n面试时，充分准备至关重要。研究公司的文化和价值观，理解他们对岗位的期望，用实例说明你是如何满足这些要求的。展示你的热情、诚实和解决问题的能力，让面试官看到你的诚意和决心。\n\n最后，保持耐心和积极态度。找工作并非一蹴而就，可能会经历挫折，但请记住，每一次的拒绝都是向成功的一步。保持开放的心态，持续学习，不断提升自己，总有一天，机会会降临到有准备的你身上。\n\n总的来说，寻找工作是一个全方位的策略性过程，需要你的智慧、努力和时间。相信自己，坚持下去，你一定能在职场上找到属于你的那片天空。祝你好运，职场之路越走越宽广！", "toolCalls": null, "toolCallId": null } } ] }}
通过prompt调用
改良版本
package test;// Copyright (c) Alibaba, Inc. and its affiliates.import com.alibaba.dashscope.aigc.conversation.Conversation;import com.alibaba.dashscope.aigc.conversation.ConversationParam;import com.alibaba.dashscope.aigc.conversation.ConversationResult;import com.alibaba.dashscope.exception.ApiException;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.alibaba.dashscope.utils.JsonUtils;public class Main { public static void quickStart() throws ApiException, NoApiKeyException, InputRequiredException { Conversation conversation = new Conversation(); String prompt = "用萝卜、土豆、茄子做饭，给我个菜谱。"; ConversationParam param = ConversationParam .builder() .model(Conversation.Models.QWEN_TURBO) .prompt(prompt) .apiKey("你的apiKey") .build(); ConversationResult result = conversation.call(param); System.out.println(JsonUtils.toJson(result)); } public static void main(String[] args) { try { quickStart(); } catch (ApiException | NoApiKeyException | InputRequiredException e) { System.out.println(e.getMessage()); } System.exit(0); }}
返回结果
{"requestId":"b384e189-4d38-9f2e-9773-8350c1934f1a", "usage":{"input_tokens":32,"output_tokens":433,"total_tokens":465}, "output":{"text":"当然可以，这里有一个简单而美味的三蔬菜炖煮菜品谱，名为\"红烧三蔬（萝卜、土豆、茄子）\"：\n\n**材料：**\n1. 萝卜1根\n2. 土豆2个\n3. 茄子2个\n4. 大葱1根\n5. 生姜2片\n6. 大蒜3瓣\n7. 食用油适量\n8. 料酒1汤匙\n9. 生抽酱油2汤匙\n10. 红糖2茶匙\n11. 清水适量\n12. 盐适量\n13. 胡椒粉适量\n14. 水淀粉（可选，用于勾芡）\n\n**步骤：**\n1. 萝卜、土豆和茄子分别洗净去皮，切成滚刀块。大葱切段，生姜和大蒜切末备用。\n2. 锅中加入适量食用油，放入红糖小火慢慢炒化，炒至红色泡沫状。\n3. 加入切好的姜蒜末，翻炒出香味。\n4. 倒入切好的萝卜块，翻煎均匀，让每一块都裹上糖色。\n5. 加入土豆块，继续翻煎至表面微黄。\n6. 将茄子块加入锅中，翻煎至所有蔬菜都略微软化。\n7. 倒入料酒，翻炒均匀后加入生抽酱油，翻炒均匀使蔬菜充分吸收调料。\n8. 加入足够的清水，水量以刚好没过蔬菜为宜。盖上锅盖，转中小火慢炖约15-20分钟，直到蔬菜熟软。\n9. 期间可根据口味加入适量的盐和胡椒粉调味。\n10. 如果喜欢汤汁浓稠，可在最后加入少量水淀粉，快速搅拌均匀即可。\n\n这道菜色泽诱人，营养丰富，是家常便饭的好选择。你可以根据个人口味调整食材份量和调料。Enjoy your meal!","finish_reason":"stop"}}官方提供的版本
// Copyright (c) Alibaba, Inc. and its affiliates.import java.util.concurrent.Semaphore;import com.alibaba.dashscope.aigc.generation.Generation;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.aigc.generation.models.QwenParam;import com.alibaba.dashscope.common.ResultCallback;import com.alibaba.dashscope.exception.ApiException;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.alibaba.dashscope.utils.JsonUtils;public class Main { private final static String PROMPT = "就当前的海洋污染的情况，写一份限塑的倡议书提纲，需要有理有据地号召大家克制地使用塑料制品"; public static void qwenQuickStart() throws NoApiKeyException, ApiException, InputRequiredException { Generation gen = new Generation(); QwenParam param = QwenParam.builder().model(Generation.Models.QWEN_TURBO).prompt(PROMPT) .topP(0.8).build(); GenerationResult result = gen.call(param); System.out.println(JsonUtils.toJson(result)); } public static void qwenQuickStartCallback() throws NoApiKeyException, ApiException, InputRequiredException, InterruptedException { Generation gen = new Generation(); QwenParam param = QwenParam.builder().model(Generation.Models.QWEN_TURBO).prompt(PROMPT) .topP(0.8).build(); Semaphore semaphore = new Semaphore(0); gen.call(param, new ResultCallback<GenerationResult>() { @Override public void onEvent(GenerationResult message) { System.out.println(message); } @Override public void onError(Exception ex){ System.out.println(ex.getMessage()); semaphore.release(); } @Override public void onComplete(){ System.out.println("onComplete"); semaphore.release(); } }); semaphore.acquire(); } public static void main(String[] args) { try { qwenQuickStart(); qwenQuickStartCallback(); } catch (ApiException | NoApiKeyException | InputRequiredException | InterruptedException e) { System.out.println(String.format("Exception %s", e.getMessage())); } System.exit(0); }}
前端最终实现效果图
后端使用通义千问SDK调用后，控制台的输出
最后附上该文章的语雀地址：博主语雀