Text Translator

Translate text between languages using Workers AI and Meta's m2m100 model. Send text via query parameters and receive a translation without external API keys.

FeaturesCopy Anchor Link

• Translate text between languages using Workers AI
• Machine translation model (@cf/meta/m2m100-1.2b) at the edge
• Stateless GET API with source text and target language
• No third-party translation service required

API ReferenceCopy Anchor Link

GET /translateCopy Anchor Link

Translates the provided text from a source language to a target language.

Example RequestCopy Anchor Link

curl "https://your-worker.workers.dev/translate?text=hello&target=es&source=en"

Success ResponseCopy Anchor Link

text string

The original input text

source string

Source language code used for translation

target string

Target language code used for translation

translation string

The translated text

{
  "text": "hello",
  "source": "en",
  "target": "es",
  "translation": "hola"
}

Error ResponseCopy Anchor Link

{
  "error": "Missing or invalid query parameter: text",
  "code": "INVALID_TEXT"
}

Error CodesCopy Anchor Link

• 400 - Missing or invalid text (INVALID_TEXT)
• 400 - Missing or invalid target (INVALID_TARGET)
• 400 - Invalid source language code (INVALID_SOURCE)
• 502 - Workers AI model run failed (AI_ERROR)

Use CasesCopy Anchor Link

• Add on-the-fly translation to edge APIs and proxies
• Localize user-facing strings without a third-party translation service
• Learn Workers AI text-to-text models in a stateless Worker
• Prototype multilingual chatbots and content tools at the edge

LimitationsCopy Anchor Link

• Workers AI is subject to usage limits by plan
• Input text length is capped
• Single-string translation; no document or batch mode

Use in your projectCopy Anchor Link

import { DEFAULT_SOURCE_LANG, MAX_TEXT_LENGTH } from "../constants/defaults";export function validateText(input: string | undefined): string | null {  if (!input || typeof input !== "string") return null;  const trimmed = input.trim();  if (!trimmed) return null;  if (trimmed.length > MAX_TEXT_LENGTH) return null;  return trimmed;}export function validateLang(input: string | undefined): string | null {  if (!input || typeof input !== "string") return null;  const trimmed = input.trim().toLowerCase();  if (!trimmed || trimmed.length > 20) return null;  return trimmed;}export function resolveSourceLang(input: string | undefined): string | null {  if (input === undefined) return DEFAULT_SOURCE_LANG;  return validateLang(input);}

DeploymentCopy Anchor Link

curl "https://your-worker.workers.dev/translate?text=hello&target=es&source=en"

Local DevelopmentCopy Anchor Link

cd apps/experiments/text-translator
npm install
npm run dev

Test locally:

curl "http://localhost:8787/translate?text=hello&target=es&source=en"

Cloudflare Features UsedCopy Anchor Link

• Workers - Edge compute runtime
• Workers AI - @cf/meta/m2m100-1.2b machine translation model