关于 translate
介绍如何通过 Sarvam AI SDK 在 Python 或 JavaScript/TypeScript 中翻译文本,并说明两种模型的功能、语言与字符限制及 API 用法差异。
主要功能
- 01Python 和 JavaScript/TypeScript SDK 示例
- 02两种翻译模型选项
- 03因模型而异的翻译控制项
- 04mayura:v1 语言自动检测
- 05API 身份验证与端点说明
- 06字符限制指南
适用场景
- 01通过 Sarvam AI SDK 翻译文本
- 02按语言和文字选项选择模型
- 03在模型限制内处理长文本
MCP 相关
该技能介绍基于 SDK 的翻译,而非 MCP 集成。README 提及 sarvam-mcp 用于聊天内翻译和本地化。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sarvamai/ skills --skill translate安装后在 Claude Code 中输入/translate确认已加载。
详细介绍
翻译 — Sarvam AI
在聊天中实时翻译/本地化 → sarvam-mcp(
sarvam_tools_translate/_localize)。此技能 = SDK 代码。
重要
身份验证:使用
api-subscription-key标头,而非Authorization: Bearer。基础 URL:https://api.sarvam.ai(不是/v1— 该前缀仅用于兼容 OpenAI 的聊天端点)
模型
| 模型 | 最大输入长度 | 语言 | 功能 |
|---|---|---|---|
sarvam-translate:v1 | 2,000 个字符 | 23 种(22 种印度语言 + 英语) | mode(仅 formal)、speaker_gender、numerals_format |
mayura:v1 | 1,000 个字符 | 11 种(10 种印度语言 + 英语) | 所有 mode 值、output_script、speaker_gender、numerals_format、自动检测源语言 |
快速开始(Python)
from sarvamai import SarvamAI
client = SarvamAI()
response = client.text.translate(
input="Hello, how are you?",
source_language_code="en-IN",
target_language_code="hi-IN",
model="sarvam-translate:v1"
)
print(response.translated_text)
快速开始(JavaScript/TypeScript)
import { SarvamAIClient } from "sarvamai";
const client = new SarvamAIClient({ apiSubscriptionKey: "YOUR_SARVAM_API_KEY" });
const response = await client.text.translate({
input: "Hello, how are you?",
source_language_code: "en-IN",
target_language_code: "hi-IN",
model: "sarvam-translate:v1"
});
console.log(response.translated_text);
注意事项
| 注意事项 | 详情 |
|---|---|
| 方法名称 | Python 和 JS 均使用:client.text.translate({...}),而非 client.translate.translate()。两个 SDK 都使用相同的 text 命名空间。 |
sarvam-translate 上的 output_script | 不支持 — 仅适用于 mayura:v1(roman、fully-native、spoken-form-in-native)。在 sarvam-translate:v1 上会被静默忽略。 |
mode 值 | sarvam-translate:v1 仅支持 formal。口语模式(modern-colloquial、classic-colloquial、code-mixed)仅适用于 mayura:v1。speaker_gender 适用于两种模型。 |
| 自动检测语言 | source_language_code="auto" 仅适用于 mayura:v1。sarvam-translate:v1 要求明确指定源语言。 |
| 奥迪亚语代码 | od-IN,而非 or-IN。 |
| 字符限制 | 超出限制会返回 422。请在句子边界处分割长文本。 |
完整文档
从以下资源获取语言代码、模式示例、文字脚本选项和数字格式:
- https://docs.sarvam.ai/llms.txt — 完整文档索引
- 翻译指南
- 速率限制
评论
支持 Markdown