Ad Localization

The Ad Localization recipe localizes an existing ad image for a target language. Provide a reference ad and a targetLanguage code — the recipe returns a localized version that keeps the visual creative and layout while adapting on-screen text.

How it works

Provide a referenceImage of the ad to localize and a targetLanguage ISO-style code (for example ja for Japanese or es for Spanish). The recipe returns a task id you poll for the localized output image.

Inputs

Input	Required	Description
version	Yes	Workflow version. Use a dated version like 2026-06 to pin behavior, or unsafe-latest to track the newest stable version.
referenceImage	Yes	Reference ad image to localize, as { uri }.
targetLanguage	Yes	Target language code — for example ja, es, zh, zh-Hant, fr, de, ko, pt, ar, and others supported by the recipe.

uri accepts an HTTPS URL, a Runway upload URI, or a data URI.

Example

Node

import RunwayML from '@runwayml/sdk';

const client = new RunwayML();

const task = await client.recipes.adLocalization({
  version: '2026-06',
  referenceImage: { uri: 'https://example.com/source-ad.jpg' },
  targetLanguage: 'ja',
});

console.log(task);

Python

from runwayml import RunwayML

client = RunwayML()

task = client.recipes.ad_localization(
  version='2026-06',
  reference_image={'uri': 'https://example.com/source-ad.jpg'},
  target_language='ja',
)

print(task)

cURL

curl -X POST https://api.dev.runwayml.com/v1/recipes/ad_localization \
  -d '{
    "version": "2026-06",
    "referenceImage": { "uri": "https://example.com/source-ad.jpg" },
    "targetLanguage": "ja"
  }' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" \
  -H "X-Runway-Version: 2024-11-06"

The recipe returns a task id. Poll GET /v1/tasks/{id} for status and the output image URL — see Using the API for the task workflow.

Tips for best results

• Use a high-resolution source ad with readable on-screen text.
• Pick the targetLanguage that matches the market you are localizing for — codes are ISO-style (for example ja, not Japanese).
• Source ads with clear typography and contrast localize more reliably than heavily stylized layouts.
• See Reference media guidelines for image input guidance.

Reference

Ad Localization API Reference See the full request and response schema in the interactive explorer.

Related

• Marketing Stock Image — on-brand stock imagery
• Product Campaign Image — campaign visuals from a product photo