通义万相 API Key 获取指南

通义万相是阿里云推出的大语言模型，旨在为用户提供强大的文本生成和图像生成能力。为了充分利用这些功能，您需要获取并配置API Key。本文将详细介绍如何获取通义万相API Key，并提供相关的使用指南和常见问题解答。

什么是通义万相API Key？

通义万相API Key是用于验证用户身份并授予访问阿里云通义万相服务权限的密钥。它是确保您的API调用安全且计费准确的关键元素。API Key类似于您的账户密码，必须妥善保管，防止泄露。

API Key 获取示意图

API Key 的重要性

API Key在与通义万相的交互中至关重要。它不仅验证您的身份，还决定了您可以访问的功能和服务。通过API Key，您可以调用各种模型服务，实现文本生成、图像生成等多种功能。

获取通义万相API Key的步骤

获取API Key的过程简单易行，只需要几个步骤即可完成。

登录或注册阿里云

首先，您需要前往阿里云官网，注册一个账户或登录现有账户。这是获取API Key的前提条件。

开通DashScope服务

在阿里云控制台中，找到DashScope服务并进行开通。开通服务后，您将能够访问API Key管理页面。

生成API Key

进入API Key管理页面，点击“创建新的API Key”按钮，系统将生成一个新的API Key。请务必妥善保存此密钥，因为它是您访问通义万相服务的凭证。

API Key 管理页面

配置API Key

获取API Key后，您需要在代码或环境中进行配置，以便于调用通义万相的API。

通过环境变量配置

推荐将API Key配置为环境变量，以提高安全性和便捷性。以下是如何在Unix系统中设置环境变量的示例：

export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

在代码中显式配置

如果无法使用环境变量，您也可以在代码中显式配置API Key。不过，需要注意的是，这种方法可能会带来安全风险。

import dashscope  
dashscope.api_key="YOUR_DASHSCOPE_API_KEY"

使用示例

提交接口调用

一旦API Key配置完成，您可以通过以下方式调用通义万相的API：

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis 
    -H 'X-DashScope-Async: enable' 
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" 
    -H 'Content-Type: application/json' 
    -d '{
    "model": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'

任务查询

通过任务ID查询生成结果：

curl -X GET 
--header "Authorization: Bearer $DASHSCOPE_API_KEY" 
https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

任务执行成功示意图

常见问题解答

FAQ

问：如何确保API Key的安全性？
- 答：避免将API Key直接写入代码中，尽量使用环境变量进行配置，并妥善保存生成的API Key。
问：API Key能否用于多个项目？
- 答：可以。一个API Key可以在不同的项目中使用，但建议根据项目需求生成不同的API Key以更好地管理权限。
问：我的API Key被泄露了怎么办？
- 答：立即在阿里云控制台的API Key管理页面删除泄露的API Key，并生成新的API Key以确保安全。
问：API调用超时怎么办？
- 答：检查网络连接，确保请求参数正确，并重试。如果问题持续，联系阿里云客服获取支持。
问：如何查看API调用的使用情况？
- 答：可以前往阿里云控制台的调用统计页面查看API调用量和调用次数。