v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB

Recipes

Localize an ad image

Localize an existing ad image for a target language, preserving visual creative while adapting on-screen messaging.

post/v1/recipes/ad_localization

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

version'2026-06' | 'unsafe-latest' required

Workflow version. Use a dated version (e.g. "2026-06") to pin behavior, or "unsafe-latest" to track the newest stable version (may break without notice).

targetLanguage'ar' | 'zh' | 'zh-Hant' | 'nl' | 'en' | 'fr' | 'de' | 'hi' | 'id' | 'it' | 'ja' | 'ko' | 'pl' | 'pt' | 'ru' | 'es' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'el' required

Target language for the localized ad. Use ISO-style codes (e.g. "ja" for Japanese, "es" for Spanish).

Example request

{
  "referenceImage": {
    "uri": "https://example.com/image.jpg"
  }
}

Response

The task that was created.

idstring uuid required

The ID of the task that was created. Use this to retrieve the task later.