文書内のテキストを翻訳
🤖/text/translate は、文書内のテキストを翻訳します。

返されたテキストをアプリケーションで使用したり、他の Robot に渡したりできます。たとえば、翻訳した字幕トラックを動画に追加できます。
この Robot が受け付けるのは、プレーンテキストや Markdown など、MIME タイプが text/* のファイルのみです。 他の形式のドキュメントは、🤖/document/convert を使用して対応するテキスト形式に変換してから処理を進めてください。
この Robot はサードパーティーの AI サービスを使用します。これらのサービスではモデルが随時調整されることがあり、同じ入力メディアでも異なる応答が返される場合があります。テストやアプリケーションでは、応答の完全一致に依存しないようにしてください。
対応言語
AWS
af, am,
ar, az, bg,
bn, bs, ca,
cs, cy, da,
de, el, en,
es, es-MX, et,
fa, fa, fa-AF,
fi, fr, fr-CA,
gu, ha, he,
hi, hr, ht,
hu, hy, id,
is, it, ja,
ka, kk, kn,
ko, lt, lv,
mk, ml, mn,
ms, mt, nl,
no, pl, ps,
pt, ro, ru,
si, sk, sl,
so, sq, sr,
sv, sw, ta,
te, th, tl,
tl, tr, uk,
ur, uz, vi,
zh, zh-TW
GCP
af, am,
ar, az, be,
bg, bn, bs,
ca, ceb, co,
cs, cy, da,
de, el, en,
eo, es, et,
eu, fa, fi,
fr, fy, ga,
gd, gl, gu,
ha, haw, he,
hi, hmn, hr,
ht, hu, hy,
id, ig, is,
it, iw, ja,
jv, ka, kk,
km, kn, ko,
ku, ky, la,
lb, lo, lt,
lv, mg, mi,
mk, ml, mn,
mr, ms, mt,
my, ne, nl,
no, ny, or,
pa, pl, ps,
pt, ro, ru,
rw, sd, si,
sk, sl, sm,
sn, so, sq,
sr, st, su,
sv, sw, ta,
te, tg, th,
tk, tl, tr,
tt, ug, uk,
ur, uz, vi,
xh, yi, yo,
zh, zh-CN, zh-TW,
zu
使用例
アップロードしたテキストファイルの内容をドイツ語に翻訳します:
{
"steps": {
"translated": {
"provider": "aws",
"robot": "/text/translate",
"target_language": "de",
"use": ":original"
}
}
}パラメーター
interpolateboolean | Record<string, boolean>処理設定の各フィールドで Assembly Variables を展開するかどうかを制御します。
デフォルトでは、Robot の処理設定のほとんどのフィールドで Assembly Variables が展開されます。すべての設定フィールドをリテラルテキストとして扱うには、このパラメーターを
falseに設定してください。特定のフィールドだけをリテラルテキストとして扱うには、そのフィールドのパスをfalseに設定してください。デフォルトでリテラルとして扱われる Robot 固有のフィールドで展開を有効にするには、このパラメーターをtrueに設定するか、そのフィールドのパスをtrueに設定してください。pathのようなフィールド名を使用してください。ネストされたオブジェクトには、ffmpeg.vfのようなドット区切りのパスを使用してください。output_metaRecord<string, boolean> | boolean | Array<string>算出に多くの CPU リソースを要するメタデータを指定できます。Assembly の処理速度を維持するため、これらはデフォルトで無効になっています。
画像の場合、このオブジェクトに
"has_transparency": trueを追加すると、画像に透明な部分が含まれるかどうかを抽出できます。"dominant_colors": trueを追加すると、画像から 16 進数のカラーコードの配列を抽出できます。画像の場合、
"blurhash": trueを追加すると、画像のプレースホルダーをコンパクトに表す BlurHash 文字列も抽出できます。画像全体の読み込み中に、ぼかしたプレビューを表示するのに役立ちます。画像の場合、代わりに
"thumbhash": trueを使用すると、base64 エンコードされた ThumbHash をmeta.thumbhashに抽出し、meta.has_alpha(完全に不透明な場合も含め、アルファチャンネルが存在するかどうか)も抽出します。ThumbHash は EXIF の向きを反映したピクセルを表し、アニメーション画像では最初のフレームを使用します。抽出はベストエフォートです。40 メガピクセルを超える画像、非対応の形式、デコードの失敗やデコード処理の上限への到達があった場合、プレースホルダーは生成されません。抽出に成功すると、そのファイルのバイト数の 20% に相当するメタデータ料金が加算されます。無効な場合やハッシュが生成されない場合、ThumbHash の追加料金は発生しません。このオプションは画像を生成する Step に設定してください。たとえば、アップロードされた元画像では
/upload/handle、処理済みの出力では/image/resizeに設定します。/transloadit/storeにのみ設定しても、抽出は要求されません。ストレージは生成元のメタデータを保持します。Transloadit Storage は生成されたハッシュをその不変のバージョンとともに永続化し、保存済みの結果やネイティブのアセット読み取り時に返します。S3 への直接アップロードではプレースホルダーは生成されません。プレースホルダーには画像情報が含まれるため、画像全体と同じアクセス制御で保護してください。動画の場合、
"colorspace": trueパラメーターを追加すると、出力動画の色空間を抽出できます。動画の場合、
"interlaced": trueを追加すると、インターレース動画かどうかも検出できます。これは、低コストの ffprobe のfield_orderフラグと、ソースの先頭フレームに対する処理範囲を制限したidetサンプリング処理を組み合わせ、file.metaの下にinterlaced、field_order、診断用のinterlace_detectionオブジェクトを出力します。この処理は計算コストが高く、それに応じて課金されます。音声の場合、
"mean_volume": trueを追加すると、音声ファイルの平均音量を表す単一の値を取得できます。また、
falseに設定すると、メタデータの抽出をスキップしてトランスコードを高速化できます。user_metaRecord<string, any>(デフォルト:{})出力される各ファイルに、ファイルの内容を変更せずにカスタム JSON メタデータを追加します。ネストしたオブジェクトと配列に対応しています。
継承の動作は Robot によって異なります。値は出力ファイルの既存の
user_metaとマージされ、一致するトップレベルのキーは現在の Step によって置き換えられます。Robot が新しい出力を作成する場合は、必要なキーを明示的に割り当ててください。処理 Step では、
${file.*}は最初の入力を、${result.*}は出力されるファイルを参照します。値は Robot の実行後、後続のメタデータ抽出と一時保存の前に、出力ごとに評価されます。:originalでは、メタデータ抽出の前にアップロードごとに値が評価されます。後続の Step は
${file.user_meta.key}を読み取ります。完全な例と継承ルールについては、カスタムメタデータ を参照してください。resultboolean(デフォルト:false)この Step の結果を Assembly Status JSON に含めるかどうか
queuebatchqueue を 'batch' に設定すると、このステップのジョブの優先度を手動で下げ、キューの待ち時間がゼロである必要のないジョブが優先ジョブスロットを消費しないようにします。
force_acceptboolean(デフォルト:false)通常は無視するファイルタイプを Robot に強制的に受け入れさせます。
デフォルトでは、Robot は認識できないファイルを無視します。たとえば、🤖/video/encodeは入力画像を無視します。
force_acceptパラメーターをtrueに設定すると、Robot に渡されたすべてのファイルを強制的に受け入れさせることができます。通常、この設定はエラーにつながるため、デバッグやエッジケースへの対処にのみ使用してください。ignore_errorsboolean | Array<meta | execute>(デフォルト:[])処理の特定のフェーズでエラーを無視します。
このパラメーターを
["meta"]に設定すると、Robot はメタデータ抽出中のエラーを無視します。このパラメーターを
["execute"]に設定すると、Robot はメイン実行フェーズ中のエラーを無視します。このパラメーターを
trueに設定すると、["meta", "execute"]と同じ動作になり、両方のフェーズでエラーを無視します。usestring | Array<string> | Array<object> | object入力として使用する Step を指定します。
- Step には任意の名前を付けられます。ただし、
":original"は Transloadit が処理するユーザーアップロード用に予約されています。 - 配列を使用して、複数の Step を入力として指定できます。
{ "use": [ ":original", "encoded", "resized" ] } - 入力 Step に
asでタグを付けて、意味上の用途を Robot に伝えることもできます。{ "use": [ { "name": ":original", "as": "image" }, { "name": ":original", "as": "mask" } ] }
ヒントuseについては、通常ここまでの内容で十分ですが、高度な使用例 も参照できます。- Step には任意の名前を付けられます。ただし、
providerauto | aws | gcp(デフォルト:"auto")リクエストに基づいて最適なプロバイダーを選択します。
自動選択を上書きするには、特定のプロバイダーを選択してください。
target_languageaf | am | ar | az | be | bg | bn |(デフォルト:"en")翻訳先の言語です。
完全に一致する言語が見つからない場合は、汎用の言語にフォールバックできます。たとえば、
"en-US"を指定すると、代わりに「en」が使用されます。各プロバイダーの対応言語一覧を参照してください。source_languageaf | am | ar | az | be | bg | bn |(デフォルト:"en")翻訳元の言語です。
デフォルトでは、どちらのプロバイダーも言語を自動検出しますが、翻訳元の言語を指定すると曖昧さを回避できる場合があります。
完全に一致する言語が見つからない場合は、汎用の言語にフォールバックできます。たとえば、
"en-US"を指定すると、代わりに「en」が使用されます。各プロバイダーの対応言語一覧を参照してください。