阿里通义千问API调用支持多种大模型,主要包括以下几种类型:
一、支持的大模型
qwen-max:这是常规的纯文本对话版本,网页版后台就使用该版本。
qwen-long:可以解读PDF、Word等文档的版本,特别适用于处理文本文件。
qwen-vl:可以解读图片的版本,支持中文多模态对话及多图对话,并具有更好的性能。
qwen-plus和qwen-turbo:这两个模型应是qwen-max的升级版,也是纯文本对话版本,可能在性能或功能上有所增强。
二、操作步骤
1. 获取API-KEY
登录阿里云百炼平台:https://bailian.console.aliyun.com/#/home。
点击个人头像,选择API-KEY。
进入API-KEY界面,点击创建新的API-KEY。
2. 选择并调用模型
返回首页,点击模型下面的“立即调用”,即可看到可以调用的模型版本。
根据需求选择合适的模型进行调用。
3. 使用DashScope SDK或OpenAI SDK调用
阿里云提供了DashScope SDK,支持Python和Java两个版本,方便开发者集成。同时,也支持通过OpenAI兼容的HTTP方式进行调用。
安装DashScope SDK:
对于Python环境,可以使用pip安装DashScope SDK:
bash复制代码pip install dashscope
或者,如果需要更新SDK,可以执行:
bash复制代码pip install dashscope --upgrade
配置API-KEY:
推荐将API-KEY配置到环境变量中以降低泄漏风险,例如,在Linux/macOS系统中,可以执行:
bash复制代码export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
或者在代码中直接设置(但这种方式存在泄露风险):
python复制代码import dashscopedashscope.api_key = "YOUR_DASHSCOPE_API_KEY"
调用模型示例:
以调用qwen-max模型进行纯文本对话为例,可以使用如下Python代码:
python复制代码
from http import HTTPStatus
from dashscope import Generation
apikey = "你的apikey"
messages = [
{'role': 'system', 'content': 'You are a helpful assistant.'},
{'role': 'user', 'content': '如何做西红柿炖牛腩?'}
]
response = Generation.call(model="qwen-max", messages=messages, result_format='message', api_key=apikey)
if response.status_code == HTTPStatus.OK:
print(response.output.choices[0].message.content)
else:
print('Request id: %s, Status code: %s, error code: %s, error message: %s' % (
response.request_id, response.status_code, response.code, response.message))
对于处理图片或文档的模型(如qwen-vl或qwen-long),调用方式类似,但需要根据模型的特性调整输入和输出的格式。
三、注意事项
在调用API时,请确保您的API-KEY处于有效状态,并且有足够的权限调用所选模型。
根据模型的不同,可能存在调用次数、并发数或数据量的限制,请参照阿里云官方文档了解详情。
如果遇到调用失败的情况,请检查网络状态、API-KEY配置以及输入参数是否正确。