月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
翻译快速开始
本教程用 REST API 完成一次文本翻译：把一句英文译为法语和祖鲁语。页面提供 C#、Go、Java、Node.js 与 Python 样例，这里以 Python 为例。
前置条件
项 | 要求 | 备注 |
Azure 订阅 | 必需 | 可免费创建 |
Translator 资源 | 在 Azure 门户创建 | 学习阶段建议使用免费层 F0，生产环境再升级 |
密钥与终结点 | 资源部署后在 Keys and Endpoint 页面获取 | 不要把密钥提交到公开仓库 |
区域 | 多服务或区域资源必须提供 | 单服务全局资源可省略 |
请求头说明：
请求头 | 要求 |
Ocp-Apim-Subscription-Key | 必需，填入资源密钥 |
Ocp-Apim-Subscription-Region | 多服务或区域资源必需；单服务全局资源可选 |
Content-Type | 必需，值为 application/json |
步骤（Python）
- 安装依赖：
pip install requests uuid。
- 新建
translator-app.py，在代码中填入密钥、终结点，以及多服务或区域资源需要的区域。
- 请求地址为
/translate，参数为api-version=3.0、from=en、to=fr和to=zu。请求体是数组，每个元素包含text。
- 运行：
python translator-app.py。
预期结果
返回 JSON 数组。每个元素包含检测到的源语言（
detectedLanguage）和 translations 列表，列表中分别为法语与祖鲁语译文。常见问题
问题 | 检查点 |
认证失败 | 密钥与终结点是否来自同一个资源 |
区域相关报错 | 使用多服务或区域资源时是否填写了区域 |
请求格式错误 | 请求体是否为数组，Content-Type 是否为 application/json |
清理资源
页面快速开始部分未包含清理步骤。使用完毕后，建议在门户中删除资源或资源组，具体操作待核实。
来源与核对
- 来源：快速开始页面，https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/rest-api；概览页面，https://learn.microsoft.com/en-us/azure/ai-services/translator/overview
- 核对范围：正文已读，覆盖前置条件、请求头、Python 步骤与预期输出。C# 等其他语言样例未逐一核对。
- 请求限制与定价层级细节见服务限额页，未读取，待核实（2026-11-05 获取）。
上一篇
视觉服务概览
下一篇
翻译服务概览
Loading...