详情

首页手游攻略 千问AI_API如何用?

千问AI_API如何用?

佚名 2026-08-08 10:11:56

必须先获取合法API密钥、安装DashScope SDK、选择合适模型并构造合规请求,缺一不可,否则返回401/400错误;密钥需在灵积平台创建并绑定FullAccess权限,SDK调用需清洗输入、限制长度,Web部署须避免硬编码并添加限流防护。

要用千问AI API让程序调用通义千问大模型能力,必须先拿到合法API密钥、装好官方SDK、选对模型、构造合规请求——缺一不可,否则会直接返回401或400错误。

在灵积平台申请并安全配置API密钥

第一步:打开阿里云灵积平台,用主账号登录。

第二步:左侧导航栏点击「API密钥管理」→「创建新的API密钥」→勾选协议后确认生成。

第三步:页面弹出的API Key值(以sk-开头)【必须完整复制且仅显示一次】,立即存入密码管理器或环境变量,切勿截图、明文写进代码、发到GitHub。

第四步:回到控制台,在「访问控制」中为该Key绑定「DashScope FullAccess」权限策略,否则调用时仍会报错403。

安装DashScope SDK并验证连接

终端执行:pip install dashscope

新建文件test_qwen.py,填入以下内容:

import dashscope

dashscope.api_key = "sk-xxx" # 替换为你的真实密钥

from dashscope import Generation

resp = Generation.call(model="qwen-turbo", prompt="你好")

print(resp.output.text if resp.status_code == 200 else "失败:" + str(resp.status_code))

运行python test_qwen.py。若输出“你好”或类似正常回复,说明SDK与密钥均有效;若报错Invalid API Key,请检查密钥是否复制完整、有无空格、是否过期。

按任务选模型并构造请求参数

方法一:轻量对话/快速响应 → 用qwen-turbo

方法二:复杂推理/长文本分析 → 用qwen-maxqwen-long

方法三:多模态理解(图文输入)→ 必须用qwen-vl,且请求体需含image_url字段,普通文本模型不支持图片解析。

注意:用户输入必须做清洗——移除x00-x08、x0B、x0C、x0E-x1F等控制字符,否则触发400 Bad Request;单次请求prompt长度建议≤3000字符,超长需分段或启用streaming模式。

用Flask部署Web服务并添加防护

第一步:新建app.py,导入Flask和dashscope。

第二步:设置环境变量加载密钥:os.environ["DASHSCOPE_API_KEY"] = os.getenv("API_KEY"),避免硬编码。

第三步:定义路由,接收POST请求,提取request.json.get("prompt"),调用Generation.call(),返回response.output.text

第四步:加入基础限流——用flask-limiter限制每IP每分钟5次调用,防止密钥泄露后被滥刷。

第五步:启动服务:flask run --host=0.0.0.0 --port=5000,前端即可通过fetch("/api/chat", {method:"POST", body:JSON.stringify({prompt:"..."})})发起调用。

相关资讯
点击查看更多
游戏推荐
推荐专题
热门阅读
推荐下载