☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在应用程序中集成人工智能能力，调用阿里通义千问API是实现国产大模型接入的关键步骤。以下是完成该接入的具体方法：
一、获取并配置API密钥
API密钥是调用通义千问服务的身份凭证，必须通过阿里云百炼平台创建并安全存储。未正确配置密钥将导致所有请求被拒绝。
1、访问阿里百炼控制台，使用主账号登录。
2、若提示“尚未实名认证”，请先完成企业或个人实名认证流程。
3、进入「API密钥管理」页面，点击「创建API Key」生成一对AccessKey ID与AccessKey Secret。
4、将AccessKey Secret复制保存至本地安全位置，该密钥仅显示一次，丢失后需重新创建。
5、在终端中执行命令将密钥设为环境变量：export DASHSCOPE_API_KEY="your_actual_api_key_here"。
二、选择并安装客户端工具
不同开发语言需对应适配的SDK或HTTP客户端，确保协议兼容性与请求格式符合DashScope规范。
1、对于Python项目，运行命令安装官方SDK：pip install dashscope。
2、对于Node.js项目，执行：npm install @dashscope/nodejs。
3、若使用curl或通用HTTP客户端，需手动构造Authorization头：Authorization: Bearer YOUR_API_KEY。
4、不建议在源代码中硬编码API密钥，应优先通过环境变量或密钥管理服务注入。
三、调用文本生成API
通义千问提供标准化的文本生成接口，支持多种模型版本，需明确指定model参数以匹配业务需求。
1、在Python脚本中导入SDK并设置密钥：import dashscope; dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")。
2、调用Generation.call方法，传入model名称（如qwen-turbo、qwen-plus或qwen-max）及prompt内容。
3、构造messages数组时，按角色顺序组织输入：[{"role": "system", "content": "你是一个助手"}, {"role": "user", "content": "你好"}]。
4、请求URL必须使用官方地址：https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation。
四、使用OpenAI兼容接口接入
已适配OpenAI标准协议的应用可复用现有逻辑，仅需更换基础URL与认证方式，降低迁移成本。
1、安装OpenAI Python客户端：pip install openai。
2、初始化OpenAI client时，base_url指向DashScope兼容端点：https://dashscope.aliyuncs.com/compatible-mode/v1。
3、model参数填写通义千问支持的型号，例如"qwen-plus"，而非OpenAI原生模型名。
4、北京地域与新加坡地域的base_url不同，跨地域调用需切换URL，否则返回404错误。
五、前端JavaScript直连方案
浏览器环境受限于CORS策略，直接暴露API密钥存在严重安全风险，必须通过代理或服务端中转。
1、在服务端（如Node.js Express）创建代理接口，接收前端POST请求并转发至DashScope API。
2、前端使用fetch发送消息到自身域名下的代理路径，避免跨域与密钥泄露。
3、代理接口中读取环境变量中的DASHSCOPE_API_KEY，并添加Bearer认证头。
4、严禁在HTML或JS文件中明文写入API_KEY，否则任何用户均可通过开发者工具窃取密钥。
