翻译
翻译是将文本从一种语言转换为另一种语言的任务。
有关translation任务的更多详细信息，请查看其专用页面！您会找到示例和相关材料。
推荐模型
- google-t5/t5-base：一个通用 Transformer，可用于将英语翻译成德语、法语或罗马尼亚语。
探索所有可用的模型并找到最适合您的模型此处。
使用 API
Python
JavaScript
cURL
import requests
API_URL = "https://api-inference.huggingface.co/models/google-t5/t5-base"
headers = {"Authorization": "Bearer hf_***"}
def query(payload):
response = requests.post(API_URL, headers=headers, json=payload)
return response.json()
output = query({
"inputs": "Меня зовут Вольфганг и я живу в Берлине",
})要使用 Python 客户端，请参阅huggingface_hub的包参考。
API 规范
请求
| 有效载荷 | ||
|---|---|---|
| inputs* | 字符串 | 要翻译的文本。 |
| 参数 | 对象 | 翻译的附加推理参数 |
| src_lang | 字符串 | 文本的源语言。对于可以从多种语言翻译的模型，这是必需的。 |
| tgt_lang | 字符串 | 要翻译到的目标语言。对于可以翻译成多种语言的模型，这是必需的。 |
| clean_up_tokenization_spaces | 布尔值 | 是否清理文本输出中潜在的多余空格。 |
| truncation | 枚举 | 可能的值：do_not_truncate、longest_first、only_first、only_second。 |
| generate_parameters | 对象 | 文本生成算法的其他参数化。 |
可以通过将标头传递到推理 API 来配置某些选项。以下是可用的标头
| 标头 | ||
|---|---|---|
| 授权 | 字符串 | 以'Bearer: hf_****'形式的认证标头，其中hf_****是具有推理 API 权限的个人用户访问令牌。您可以从您的设置页面生成一个。 |
| x-use-cache | 布尔值，默认为true
| 推理 API 上有一层缓存层，用于加速我们已经见过的请求。大多数模型可以使用这些结果，因为它们是确定性的（意味着输出无论如何都会相同）。但是，如果您使用非确定性模型，您可以设置此参数以防止使用缓存机制，从而产生一个真正的新的查询。点击此处了解更多关于缓存的信息。 |
| x-wait-for-model | 布尔值，默认为false | 如果模型未准备好，则等待它，而不是接收 503 错误。它限制了完成推理所需的请求数量。建议仅在收到 503 错误后才将此标志设置为 true，因为它会将应用程序挂起限制在已知位置。点击此处了解更多关于模型可用性的信息。 |
有关推理 API 标头的更多信息，请查看参数指南。
响应
| 主体 | ||
|---|---|---|
| translation_text | 字符串 | 翻译后的文本。 |