
FastAPI是什么?快速上手指南
阿里云通義千問 API 基于 “OpenAI 兼容模式” 設計,只需替換 base_url
即可在現有 OpenAI SDK 中調用,大幅降低遷移成本。
獲取 API Key
將憑證設置為環境變量:
export DASHSCOPE_API_KEY="你的API_KEY"
配置 SDK
使用 OpenAI Python SDK:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("DASHSCOPE_API_KEY"),
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
)
發送對話請求
response = client.chat.completions.create(
model="qwen-plus",
messages=[
{"role": "system", "content": "你是一個智能對話助手,精通中文和英語。"},
{"role": "user", "content": "幫我分析這張圖片中的物品都有哪些。"}
],
stream=False
)
print(response.choices[0].message.content)
解析返回
choices[0].message.content
:模型生成的文字回復。usage
:Token 使用量,用于成本監控。messages
中加入 {"role":"user","content": " < Base64 圖像 > "}]
實現圖像問答。通義千問 API 在中文和英文雙語理解上表現出色,自然語言處理(NLP) 能力涵蓋:
針對 代碼生成 和 數學推理 場景,Qwen?Plus 與 Qwen?Max 增強了編程知識預訓練:
模型 | 特點 | 適用場景 |
---|---|---|
qwen?turbo | 輕量、低成本、響應迅速 | 簡單問答、聊天機器人 |
qwen?plus | 平衡性能與成本 | 技術問答、文章生成 |
qwen?max | 高精度、多任務 | 法律顧問、科研輔助 |
qwen?vl | 圖文問答、OCR、場景分析 | 電商商品識別、文檔分析 |
萬相模型 | 文生圖、文生視頻 | 營銷短視頻、社交封面圖 |
結合 通義千問 API 的 函數調用 功能,實現外部業務系統集成:
# 定義函數 schema
functions = [{
"name": "query_inventory",
"description": "查詢商品庫存",
"parameters":{
"type":"object",
"properties":{
"item_id":{"type":"string"},
"location":{"type":"string"}
},
"required":["item_id"]
}
}]
# 首次對話請求
resp = client.chat.completions.create(
model="qwen-plus",
messages=[
{"role":"system","content":"你是庫存查詢助手。"},
{"role":"user","content":"查詢商品12345在上海倉庫的庫存。"}
],
functions=functions
)
# 模型觸發函數調用
if resp.choices[0].message.function_call:
args = json.loads(resp.choices[0].message.function_call.arguments)
data = query_inventory_api(item_id=args["item_id"], location=args.get("location"))
# 插入 function 返回并繼續對話
follow = client.chat.completions.create(
model="qwen-plus",
messages=[
*resp.choices[0].message, # 上一次消息
{"role":"function","name":"query_inventory","content":json.dumps(data)}
]
)
print(follow.choices[0].message.content)
stream=True
即可實現流式響應,適合聊天界面。智能客服系統
電商商品運營
內容創作與編輯
教育與輔導平臺
參數調優:
temperature
: 0.2–0.5 平衡穩定性與創造性top_p
: 0.8–1.0 控制多樣性max_tokens
: 根據場景限制生成長度usage
數據監控 token 消耗與調用次數,結合告警與自動擴容機制。隨著 通義千問 API 的持續迭代和多模態能力的深入擴展,未來將出現更多創新應用:
阿里云通義千問 API 憑借強大的自然語言處理能力、多模態創新功能與函數調用機制,為智能客服、電商運營、內容創作、教育輔導等場景帶來革新性體驗。開發者只需幾行代碼即可接入 Qwen?Plus 或 Qwen?VL,快速構建高效、穩定且合規的對話式 AI 服務。希望本篇文章能幫助你全面掌握通義千問 API 的核心原理與實戰技巧,加速你的智能應用落地之旅!
原文引自YouTube視頻:https://www.youtube.com/watch?v=6MtQZIonJuQ