微软 Azure OpenAI 学生免费额度申请：每月约 200 美元信用

Azure OpenAI 不使用 api.openai.com，而是每个资源一个独立域名。base_url 形如 https://example-resource.openai.azure.com，经典接口的完整路径是 /openai/deployments/你的部署名/chat/completions?api-version=2024-10-21，必须带 api-version 查询参数；较新的 v1 接口则是 https://example-resource.openai.azure.com/openai/v1，路径与 OpenAI 官方一致，新项目优先选它。模型名就是你创建的部署名，可在门户「模型部署」页查看，不是 gpt-4o 这类原始型号名。

先把凭据写进环境变量，避免硬编码在代码里：

export AZURE_OPENAI_API_KEY="在这里粘贴门户里的密钥"
export AZURE_OPENAI_ENDPOINT="https://example-resource.openai.azure.com"
export AZURE_OPENAI_DEPLOYMENT="gpt-4o-mini-deploy"

最直接的一次对话补全调用可以用 curl 验证，注意鉴权头是 api-key 而不是 Bearer：

curl "https://example-resource.openai.azure.com/openai/deployments/gpt-4o-mini-deploy/chat/completions?api-version=2024-10-21" \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -d '{
    "messages": [
      {"role": "system", "content": "你是一个简洁的技术助手。"},
      {"role": "user", "content": "用一句话说明什么是 REST API。"}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

用官方 Python SDK 时，把 azure_endpoint 和 api_version 交给客户端，model 传部署名：

import os
from openai import AzureOpenAI

client = AzureOpenAI(
    api_key=os.environ["AZURE_OPENAI_API_KEY"],
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version="2024-10-21",
)

resp = client.chat.completions.create(
    model=os.environ["AZURE_OPENAI_DEPLOYMENT"],
    messages=[
        {"role": "system", "content": "你是一个简洁的技术助手。"},
        {"role": "user", "content": "用一句话说明什么是 REST API。"},
    ],
    temperature=0.7,
    max_tokens=256,
)

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

关键参数

• messages：必填，按 system、user、assistant 三种角色组织上下文，长度受模型上下文窗口限制。
• temperature：取值 0 到 2，越低越稳定，做抽取、分类时建议 0 到 0.3。
• max_tokens：限制输出长度，部分新模型改用 max_completion_tokens，报参数不支持时换用后者。
• stream：设为 true 可流式返回，适合聊天类界面，注意拼接增量片段。
• api-version：查询参数，缺失直接报错；不同版本支持的参数集合不同，升级前先看变更说明。

额度耗尽与限流的排查顺序

1. 先看 HTTP 状态码：401 多为密钥错误或密钥与终结点不属于同一资源；403 常是模型或功能未获批；404 基本是部署名拼错或路径里漏了 api-version。
2. 再确认 model 字段填的是部署名，且该部署处于成功状态，而不是仍在创建中。
3. 出现 429 时先区分是配额限流还是额度不足：响应头里的 retry-after 表示需要退避的秒数，属于 TPM/RPM 限流，做指数退避重试或到门户调高配额即可。
4. 如果门户「信用额度」显示已用尽或已过期，请求会持续失败，此时只能升级为按量付费订阅，或换用其它账号的赠额。
5. 最后核对资源区域与模型可用性，以及订阅是否因未验证支付方式被禁用，这类问题在客户端看不出原因，必须回门户查看资源状态与计费提醒。