az cognitiveservices account create \
--name my-openai-resource \
--resource-group my-resource-group \
--kind OpenAI \
--sku S0 \
--location eastus2 \
--yes

1.3 獲取API密鑰與終結點

在Azure門戶導航至創建的OpenAI資源

  1. 在”密鑰和終結點”頁面獲取:

第二章 API基礎調用實踐

2.1 環境配置

pip install python-dotenv openai

創建.env文件:

AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
AZURE_OPENAI_KEY=your-api-key
AZURE_OPENAI_DEPLOYMENT=your-deployment-name

2.2 文本補全示例

import os
from dotenv import load_dotenv
from openai import AzureOpenAI

load_dotenv()

client = AzureOpenAI(
api_key=os.getenv("AZURE_OPENAI_KEY"),
api_version="2024-02-01",
azure_endpoint=os.getenv("AZURE_OPENAI_ENDPOINT")
)

response = client.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
prompt="人工智能將改變",
temperature=0.7,
max_tokens=100
)

print(response.choices[0].text)

參數說明表:

參數類型說明推薦值
temperaturefloat生成隨機性0.5-1.0
max_tokensint最大輸出長度根據需求調整
top_pfloat核采樣閾值0.9-1.0
frequency_penaltyfloat重復懲罰系數0.0-2.0

第三章 高級功能實戰

3.1 聊天補全API

response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=[
{"role": "system", "content": "你是一位資深技術專家"},
{"role": "user", "content": "請用通俗語言解釋量子計算"}
],
temperature=0.5
)

print(response.choices[0].message.content)

消息角色說明:

3.2 流式響應處理

response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=[{"role": "user", "content": "講述一個科技創業故事"}],
stream=True
)

for chunk in response:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")

3.3 函數調用能力

tools = [
{
"type": "function",
"function": {
"name": "get_current_weather",
"description": "獲取當前天氣",
"parameters": {
"type": "object",
"properties": {
"location": {"type": "string"}
}
}
}
}
]

response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=[{"role": "user", "content": "北京現在天氣如何?"}],
tools=tools
)

print(response.choices[0].message.tool_calls)

第四章 企業級最佳實踐

4.1 安全與合規配置

  1. 啟用私有網絡端點
  2. 配置數據駐留策略
  3. 設置內容過濾規則
# 啟用內容過濾
response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=[...],
filter_params={
"hate": "block",
"self_harm": "alert"
}
)

4.2 性能優化技巧

4.3 成本控制策略

  1. 監控使用指標
az monitor metrics list \
--resource my-openai-resource \
--metric "TotalTokens"
  1. 設置用量預警
  2. 選擇合適模型層級(如gpt-35-turbo vs gpt-4)

第五章 典型應用場景

5.1 智能客服系統

def generate_response(query):
history = load_chat_history()
messages = [
{"role": "system", "content": "你是一個專業的客服助理"},
*history,
{"role": "user", "content": query}
]

response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=messages,
temperature=0.3
)

return response.choices[0].message.content

5.2 文檔智能處理

def summarize_document(text):
response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=[{
"role": "user",
"content": f"請用三點總結以下文檔內容:\n{text}"
}],
temperature=0.1
)
return response.choices[0].message.content

5.3 代碼生成助手

def generate_python_code(requirement):
messages = [
{"role": "system", "content": "你是一個專業的Python開發助手"},
{"role": "user", "content": f"請生成滿足以下需求的Python代碼:{requirement}"}
]

response = client.chat.completions.create(
model=os.getenv("AZURE_OPENAI_DEPLOYMENT"),
messages=messages,
temperature=0.2
)

return extract_code(response.choices[0].message.content)

第六章 常見問題排查

6.1 認證失敗問題

6.2 速率限制處理

from tenacity import retry, wait_exponential

@retry(wait=wait_exponential(multiplier=1, max=10))
def safe_api_call():
return client.chat.completions.create(...)

6.3 輸出質量優化

  1. 改進prompt工程
  2. 調整temperature參數
  3. 使用few-shot learning
  4. 添加輸出格式約束

結語:開啟AI創新之旅

通過本教程,您已經掌握了Azure OpenAI API的核心使用方法和最佳實踐。建議從以下方向深入探索:

  1. 集成到現有業務系統
  2. 構建定制化微調模型
  3. 開發創新型AI應用
  4. 參與Microsoft AI開發者社區

Azure OpenAI正在持續更新模型版本和功能特性,建議定期查閱官方文檔獲取最新信息。期待您利用這項強大的技術創造出改變世界的應用!

上一篇:

Ollama Python 調用:本地大模型的高效交互方式

下一篇:

FastOpenAPI:Python框架API文檔自動化生成工具,解放你的雙手!
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費