translate について
Sarvam AI SDKを使い、PythonまたはJavaScript/TypeScriptでテキストを翻訳するスキルです。2種類のモデルの機能、言語や文字数の制限、API利用上の違いを説明します。
主な機能
- 01PythonとJavaScript/TypeScriptのSDK例
- 022種類の翻訳モデル
- 03モデル別の翻訳設定
- 04mayura:v1による言語自動検出
- 05API認証とエンドポイントの案内
- 06文字数制限の説明
活用シーン
- 01Sarvam 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 対応