Our /text/translate Robot

Translate text

🤖/text/translate translates text in documents.

You can use the text that we return in your application, or you can pass the text down to other Robots to add a translated subtitle track to a video for example.

This Robot accepts only files with a text/* MIME-type, including plain text and Markdown. For documents in other formats, use 🤖/document/convert to first convert them into a compatible text format before proceeding.

Warning: This Robot uses third-party AI services. They may tweak their models over time, giving different responses for the same input media. Avoid relying on exact responses in your tests and application.

Supported languages

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-CN, zh, zh-TW, zu

Usage example

Translate uploaded text file contents to German:

{
  "steps": {
    "translated": {
      "robot": "/text/translate",
      "use": ":original",
      "target_language": "de",
      "provider": "aws"
    }
  }
}

Parameters

  • use

    String / Array of Strings / Object required

    Specifies which Step(s) to use as input.

    • You can pick any names for Steps except ":original" (reserved for user uploads handled by Transloadit)

    • You can provide several Steps as input with arrays:

      "use": [
  ":original",
  "encoded",
  "resized"
]

    💡 That’s likely all you need to know about use, but you can view Advanced use cases.

  • provider

    Stringrequired

    Which AI provider to leverage. Valid values are "aws" (Amazon Web Services) and "gcp" (Google Cloud Platform).

    Transloadit outsources this task and abstracts the interface so you can expect the same data structures, but different latencies and information being returned. Different cloud vendors have different areas they shine in, and we recommend to try out and see what yields the best results for your use case.

  • target_language

    String ⋅ default: "en"

    The desired language to translate to.

    If the exact language can't be found, a generic variant can be fallen back to. For example, if you specify "en-US", "en" will be used instead. Please consult the list of supported languages for each provider.

  • source_language

    String

    The desired language to translate from.

    By default, both providers will detect this automatically, but there are cases where specifying the source language prevents ambiguities.

    If the exact language can't be found, a generic variant can be fallen back to. For example, if you specify "en-US", "en" will be used instead. Please consult the list of supported languages for each provider.

Demos

Related blog posts