区块链API推荐，快速开发去中心化应用
如何获取通义千问API密钥(分步指南)
2024-11-14
通义千问API是由阿里云自主研发的大语言模型，用于理解和分析用户输入的自然语言，在不同领域和任务为用户提供服务和帮助。您可以通过提供尽可能清晰详细的指令，来获取符合您预期的结果。在全球化日益加深的今天，即时通讯工具中的多语言支持成为了连接不同文化和背景的桥梁。通义千问API正是为此提供了一种高效的多语言聊天解决方案，它支持实时的文本和语音翻译，极大地促进了用户间的无缝沟通。无论你是在开发国际版的社交应用、企业级沟通平台还是其他需要多语言支持的场景，通义千问API都能为你的产品增添强大的跨语言能力。
本文将详细指导你如何获取通义千问API的密钥。通过一系列简单而明确的步骤，你将能够轻松获得这一强大的通讯工具。一旦获得 API 密钥，你就可以开始在你的平台中集成通义千问API，为用户提供即时且准确的翻译服务。
1. 登录注册阿里云
2. 开通DashScope
您需要在开通DashScope后，才可以获得API-KEY。开通DashScope请参考以下步骤：
- 访问DashScope管理控制台：前往控制台。
- 在控制台“总览”页下，单击去开通。
- 阅读服务协议，确认无误后单击立即开通。
3. 获取API-KEY
您可以按照以下步骤获取DashScope的API-KEY。
- 访问DashScope管理控制台API-KEY管理页面：前往API-KEY管理，单击创建新的API-KEY。
- 系统创建生成API-KEY，并在弹出的对话框中展示，您可以单击复制按钮将API-KEY的内容复制保存。
- 复制并在安全的地方保存API-KEY后，单击我已保存，关闭。此次创建的API-KEY可立即用于调用DashScopeAPI，对API-KEY的后续操作均可在当前的API-KEY管理页面进行。
4. 配置API
在您获取到API-KEY后，可在您的业务代码中配置API-KEY值来使用DashScope的模型服务。您可以通过以下两种方式进行配置。
方式一：通过环境变量设置API-KEY（推荐）
环境变量是操作系统中用于存储有关系统环境的信息的变量。您可以通过环境变量来配置API-KEY，这样即使您的代码库被公开，API-KEY也不会泄漏。您可以根据您的操作系统与使用场景来确定添加API-KEY到环境变量中的方法。
方式一：添加临时性环境变量
如果您仅需要在当前会话中添加并使用临时性环境变量，可以运行以下命令：
# 用您的 API-KEY 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"您可以在当前会话运行以下命令检查环境变量是否生效：
echo $DASHSCOPE_API_KEY方式二：对当前用户添加永久性环境变量
如果您需要对当前用户添加永久性环境变量，使得在该用户的新会话中也可以使用该环境变量，可以把以下命令语句复制并添加到~/.bashrc文件中：
# 用您的 API-KEY 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"或直接运行以下命令将上述命令语句添加到~/.bashrc中：
# 用您的 API-KEY 代替 YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc添加完成后，您可以运行以下命令使环境变量生效：
source ~/.bashrc您可以新建一个会话，运行以下命令检查环境变量是否生效：
echo $DASHSCOPE_API_KEY方式二：在代码中显式配置API-KEY
我们不建议您将API-KEY直接写在代码中，可能存在泄露风险。如果您没有配置环境变量，可以参考以下示例代码，在代码中配置API-KEY。
import dashscope
dashscope.api_key="YOUR_DASHSCOPE_API_KEY"5. 请求示例
提交接口调用
curl --location 'https://dashscope.aliyuncs.com/api/v1/uploads?action=getPolicy&model=qwen-vl-plus' \
--header 'Authorization: Bearer your-dashscope-api-key' \
--header 'Content-Type: application/json'入参描述
| 传参方式 | 字段 | 类型 | 必选 | 描述 | 示例值 |
| Header | Content-Type | string | 是 | 请求类型：application/json 。 | application/json |
| Authorization | string | 是 | API-Key，例如：Bearer d1**2a。 | Bearer d1**2a | |
| Query | action | string | 是 | 操作类型，当前场景为getPolicy。 | getPolicy |
| model | string | 是 | 指明数据准备完成后最终需要调用的模型名称。 | qwen-vl-plus |
出参描述
| 字段 | 类型 | 描述 | 示例值 |
| request_id | string | 本次请求的系统唯一码。 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
| data | object | – | – |
| data.policy | string | 上传凭证。 | eyJleHBpcmF0aW9 … … … dHJ1ZSJ9XX0= |
| data.signature | string | 上传凭证的签名。 | Sm/tv7DcZuTZftFVvt5yOoSETsc= |
| data.upload_dir | string | 上传文件的目录。 | dashscope-instant/088726756f74fece22e2a645e2600c01/20xx-xx-xx/c0087628-5c77-90de-bf38-61ecc3a032bc |
| data.upload_host | string | 上传的host地址。 | https://dashscope.oss-cn-beijing.aliyuncs.com |
| data.expire_in_seconds | string | 上传凭证过期时间（单位秒）。 | 300 |
| data.max_file_size_mb | string | 本次最大允许的上传文件的大小（单位MB），和用户需要访问的模型相关。 | 100 |
| data.capacity_limit_mb | string | 同一个用户每天的上传容量限制（单位MB）。 | 999999999 |
| data.oss_access_key_id | string | 用于上传的access key。 | LTAm5tHvsJAXf7ndvSyY**** |
| data.x_oss_object_acl | string | 上传的文件访问权限，private意味着私有。 | private |
| data.x_oss_forbid_overwrite | string | 文件同名时是否可以覆盖，true意味着不可覆盖。 | true |
响应示例
{
"request_id": "xxx",
"data": {
"policy": "eyJl...1ZSJ9XX0=",
"signature": "g5K...d40=",
"upload_dir": "dashscope-instant/xxx/2024-07-18/xxxx",
"upload_host": "https://dashscope-file-xxx.oss-cn-beijing.aliyuncs.com",
"expire_in_seconds": 300,
"max_file_size_mb": 100,
"capacity_limit_mb": 999999999,
"oss_access_key_id": "LTAxxx",
"x_oss_object_acl": "private",
"x_oss_forbid_overwrite": "true"
}
}6. 常见问题
Q：如何找到通义千问API
A：幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’通义千问API‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。
Q：语音模型计价？
A：
文字转语音（Text-to-Speech）
下表以 1K 字符 为计价单位，列出 通义千问 中调用 TTS 模型对应的计算积分。
模型：OpenAI TTS 输入1k 字符：15,000计算积分
模型：OpenAI TTS HD 输入1k 字符：30,000计算积分
语音转文字（Speech-to-Text）
下表以 每分钟 为计价单位，列出 通义千问 中调用 STT 模型对应的计算积分。
模型：OpenAI Whisper
输入每分钟：6,000计算积分
Q：什么是API-KEY？
A：DashScope通过API-KEY进行调用鉴权和计量计费，目前支持主账号进行API-KEY的管理。
Q：API-KEY的上限个数是多少？
A：当前每个主账号可以同时有3个生效的API-KEY。
Q：API-KEY被删除会有什么影响？
A：目前支持主账号对API-KEY的删除，子账号无法进行操作。删除的API-KEY无法找回也无法使用，但您在调用统计页面仍能查询被删除的API-KEY以往的调用统计结果。
Q：新上架的模型是否需要重新开通？
A：当您已完成服务开通后，DashScope提供的模型有新增或迭代时，您无需重新开通即可直接按照流程进行调用。
Q：通义千问API的替代品有哪些？
提供AI大模型API的服务商除了通义千问API，还有其他替代服务商也提供类似api服务，例如：
360多模态大语言模型、语音大模型服务MiniMax-稀宇科技、通用大模型开放平台-华藏、讯飞星火认知大模型
更多竞品可以在幂简集成开放平台中找到。
Q：通义千问API这个密钥还适用于哪些api？
7. 总结
本文详细阐述了获取通义千问API密钥的全过程，为开发者提供了清晰的分步指南。从通义千问API注册账号开始，通过完成开发者认证，到最终获取API服务密钥，每一步都进行了详尽的说明。此外，文章还强调了获取密钥后进行可用性测试的重要性，确保开发者能够顺利地将API集成到应用中。本文为开发者提供了一个全面、实用的指南，帮助他们顺利获取通义千问API密钥，并有效地将这一能力集成到应用中，从而提升应用的交互性和功能性。
同话题下的热门内容
