大模型的训练与应用 | 二十、阿里云通义千问API申请与使用指南

大模型本地部署_

已于 2024-08-20 19:04:53 修改

阅读量2.5k

点赞数 29

文章标签：阿里云人工智能 ai agi python 大模型学习

于 2024-07-31 19:08:44 首次发布

本文链接：https://blog.csdn.net/Androiddddd/article/details/140830399

版权

阿里云通义千问API是阿里云推出的一款基于超大规模语言模型的人工智能服务，它能够帮助开发者快速构建各种智能应用。下面将为您提供一份详尽的申请与使用指南。

一、了解通义千问API

通义千问API基于阿里云自主研发的超大规模语言模型，具备强大的语言理解与生成能力，广泛应用于聊天机器人、内容创作、知识问答等场景。

二、申请API Key

1）注册阿里云账号

如果您还没有阿里云账号，请先在阿里云官网注册。

2）访问DashScope控制台

登录阿里云账号后，访问DashScope控制台。

3）实名认证

根据页面提示完成实名认证，这是获取API Key的前提条件。

4）创建API Key

在控制台中创建新的API Key，记录下生成的Key，它将作为后续API调用的身份验证凭证。

三、安装DashScope SDK

1）选择开发语言

DashScope SDK支持Python和Java两种语言，根据您的开发需求选择相应的SDK。

2）安装Python SDK

如果使用Python开发，通过以下命令安装或更新SDK：

pip install dashscope --upgrade -i https://pypi.tuna.tsinghua.edu.cn/simple

3）安装Java SDK

如果使用Java开发，请根据官方文档指引安装Java SDK。

四、配置API Key

1）设置环境变量

为安全起见，建议将API Key设置为环境变量，避免在代码中硬编码。

2）配置示例

以Python为例，您可以在.env文件中添加以下内容：

DASHSCOPE_API_KEY=您的API_Key

五、编写客户端程序

1）导入SDK

根据开发语言导入相应的DashScope模块。

2）编写调用代码

使用申请到的API Key，编写客户端程序调用通义千问API。以下是Python和Java的示例代码：

Python示例：

from http import HTTPStatus
import dashscope
def call_with_messages():
    messages = [
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '请介绍一下通义千问'}
    ]
    response = dashscope.Generation.call(
        dashscope.Generation.Models.qwen_turbo,
        messages=messages,
        result_format='message'
    )
    if response.status_code == HTTPStatus.OK:
        print(response)
    else:
        print('Request id: %s, Status code: %s, error code: %s, error message: %s' % (
            response.request_id, response.status_code,
            response.code, response.message
        ))
if __name__ == '__main__':
    call_with_messages()

Java示例：

import java.util.ArrayList;
import java.util.List;
// 其他导入...
public class Main {
    public static void callWithMessage()
            throws NoApiKeyException, ApiException, InputRequiredException {
        Generation gen = new Generation();
        List<Message> messages = new ArrayList<>();
        Message systemMsg = Message.builder()
                .role(Role.SYSTEM.getValue())
                .content("You are a helpful assistant.")
                .build();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("请介绍一下通义千问")
                .build();
        messages.add(systemMsg);
        messages.add(userMsg);
        GenerationParam param = GenerationParam.builder()
                .model(Generation.Models.QWEN_TURBO)
                .messages(messages)
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .build();
        GenerationResult result = gen.call(param);
        System.out.println(JsonUtils.toJson(result));
    }
    public static void main(String[] args){
        try {
            callWithMessage();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}