阿里通义千问：官方开放API开发基础_通义api

目录

一、模型介绍

1.1主要模型

1.2 计费单价

二、前置条件

2.1 开通DashScope并创建API-KEY

2.2 设置API-KEY

三、基于DashScope SDK开发

3.1 Maven引入SDK

3.2 代码实现

3.3 运行代码

---

一、模型介绍

        通义千问是由阿里云自主研发的大语言模型，用于理解和分析用户输入的自然语言，在不同领域、任务内为用户提供服务和帮助。您可以通过提供尽可能清晰详细的指令，来获取符合您预期的结果。

1.1主要模型

1.2 计费单价

        Token是模型用来表示自然语言文本的基本单位，可以直观地理解为“字”或“词”。对于中文文本来说，1个token通常对应一个汉字；对于英文文本来说，1个token通常对应3至4个字母。

        通义千问模型服务根据模型输入和输出的总token数量进行计量计费，其中多轮对话中的history作为输入也会进行计量计费。每一次模型调用产生的实际token数量可以从 response 中获取。

        实际收费情况请关注官方信息。

二、前置条件

2.1 开通DashScope并创建API-KEY

        需要通过阿里云主账号或者得到主账号AliyunDashScopeFullAccess授权的子账号进行DashScope模型服务的开通及API-KEY的创建，具体参考官方文档。

2.2 设置API-KEY

        推荐将API-KEY配置到环境变量中以降低API-KEY的泄漏风险，详情可参考通过环境变量配置API-KEY。也可以在代码中配置API-KEY，但是泄漏风险会提高。

        SDK 支持从环境变量 API-KEY 获取配置，这一步骤会在使用 SDK 时自动完成。

# linux
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

#windows
setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"

        同时，也可以在通过代码设置,通常不推荐将api-key直接写在代码中：

import com.alibaba.dashscope.utils.Constants;
Constants.apiKey="YOUR_DASHSCOPE_API_KEY";

三、基于DashScope SDK开发

3.1 Maven引入SDK

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
 
    <groupId>com.yichenkeji</groupId>
    <artifactId>yichen-demo-qwen</artifactId>
    <version>1.0-SNAPSHOT</version>
 
    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
 
    <dependencies>
        <!-- https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>dashscope-sdk-java</artifactId>
            <version>2.13.0</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.73</version>
        </dependency>
    </dependencies>
</project>

3.2 代码实现

package com.yichenkeji.demo.qwen;
 
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.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.fastjson.JSON;
 
 
public class QwenMain {
    public static String chat(String message) {
        Generation gen = new Generation();
        MessageManager msgManager = new MessageManager(10);
        //构建信息对象
        Message userMsg = Message.builder().role(Role.USER.getValue()).content(message).build();
        msgManager.add(userMsg);
        QwenParam param =
                QwenParam.builder()
                        .model(Generation.Models.QWEN_TURBO) //设置模型名称
                        .messages(msgManager.get())
                        .resultFormat(QwenParam.ResultFormat.MESSAGE)
                        .build();
 
        try {
            GenerationResult result = gen.call(param);
            return JSON.toJSONString(result);
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
 
 
    public static void main(String[] args) {
        String result = chat("请做一下自我介绍");
        System.out.println(result);
    }
}

3.3 运行代码