通义千问API调用快速开始

通义千问

通义千问是阿里巴巴达摩院自主研发的超大规模语言模型，能够在用户自然语言输入的基础上，通过自然语言理解和语义分析，在不同领域、任务内为用户提供服务和帮助。

模型具备的能力包括但不限于：

1. 创作文字，如写故事、写公文、写邮件、写剧本、写诗歌等

2. 编写代码

3. 提供各类语言的翻译服务，如英语、日语、法语、西班牙语等

4. 进行文本润色和文本摘要等工作

5. 扮演角色进行对话

6. 制作图表

快速开始

前提条件

• 已开通服务并获得API-KEY：开通DashScope并创建API-KEY。

• 已安装最新版SDK：安装DashScope SDK。

示例代码

以下示例展示了调用通义千问API对一个用户指令进行响应的代码。

设置API-KEY

export DASHSCOPE_API_KEY=YOUR_DASHSCOPE_API_KEY

# For prerequisites running the following sample, visit https://help.aliyun.com/document_detail/611472.html

import dashscope
from dashscope import Generation
from http import HTTPStatus

response = Generation.call(
    model='qwen-v1',
    prompt='就当前的海洋污染的情况，写一份限塑的倡议书提纲，需要有理有据地号召大家克制地使用塑料制品'
)
# The response status_code is HTTPStatus.OK indicate success,
# otherwise indicate request is failed, you can get error code
# and message from code and message.
if response.status_code == HTTPStatus.OK:
    print(response.output)  # The output text
    print(response.usage)  # The usage information
else:
    print(response.code)  # The error code.
    print(response.message)  # The error message.

import com.alibaba.dashscope.aigc.conversation.Conversation;
import com.alibaba.dashscope.aigc.conversation.ConversationResult;
import com.alibaba.dashscope.aigc.conversation.qwen.QWenConversationParam;
import com.alibaba.dashscope.utils.JsonUtils;

public class Main {

    public static void main(String[] args) {
        Conversation conversation = new Conversation();

        QWenConversationParam param =
                QWenConversationParam.builder()
                        .model(QWenConversationParam.QWEN_V1)
                        .prompt("就当前的海洋污染的情况，写一份限塑的倡议书提纲，需要有理有据地号召大家克制地使用塑料制品")
                        .apiKey("your-dashscope-api-key")
                        .build();
        // 如果正常返回即可以直接使用
        // 否则会抛出ApiException异常，检查e.getStatus()即可拿到错误信息
        ConversationResult result = conversation.call(param);
        System.out.println(JsonUtils.toJson(result));
        System.exit(0);
    }
}

{"text": "好的，以下是一份限塑的倡议书提纲，以理性有据的方式号召大家克制使用塑料制品：\n\n1. 什么是塑料污染？\n- 塑料污染指的是人类过度使用塑料制品，导致大量塑料垃圾被遗弃在海洋中，对海洋生态环境造成严重危害。\n- 塑料污染的危害包括：破坏海洋生态系统，导致生物多样性下降；阻碍海洋通道，影响渔业和航运；危及人类健康，影响饮用水安全等。\n\n2. 限塑的必要性\n- 为了保护海洋生态环境，我们需要限制塑料的使用，减少对海洋的污染。\n- 限制塑料使用并不是“不环保”，恰恰相反，限制塑料的使用可以更好地保护环境。\n- 我们可以采用可降解的替代品，如纸袋、竹篮等。\n\n3. 推广可降解替代品\n- 我们可以推广可降解的替代品，如纸袋、竹篮等，这些替代品不仅可以减少塑料的使用，而且可以促进环保和可持续发展。\n- 政府和企业可以采取一些措施，如提供奖励、加强宣传等，鼓励更多人使用可降解替代品。\n\n4. 鼓励大家节约使用塑料制品\n- 我们可以通过鼓励大家节约使用塑料制品，如减少一次性塑料餐具、购物袋等的使用，来减少塑料污染。\n- 政府和企业可以通过减免税收等方式，鼓励企业采用环保材料制品。\n\n5. 积极参与环保行动\n- 我们每个人都可以积极参与环保行动，如垃圾分类、节约用水、节能减排等，为环保事业做出贡献。\n- 政府和企业可以提供更多的环保服务和设施，以方便大家参与环保行动。\n\n希望这份提纲可以帮助大家更好地了解限塑的必要性，并鼓励大家克制使用塑料制品，为环保事业做出贡献。"}
{"input_tokens": 51, "output_tokens": 629}

了解更多

有关通义千问模型API的详细调用文档可前往API详情页面进行了解。