release: 4.9.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.8.0"
+  ".": "4.9.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 50
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runwayml/runwayml-caa255c8f1c6fd2b54d331eeacc13de517b8dbaba491ef94745d107798b5eb7a.yml
-openapi_spec_hash: d9f7b43604b06f389e2fc45376d0a519
-config_hash: 955a0e451964a44778c5c0f54ca1c994
+configured_endpoints: 51
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runwayml/runwayml-d934e6804620f70a9a7d88bb3acf27146b57860ed56691e390e46027b3c04d4a.yml
+openapi_spec_hash: 132fc1ce816bcfd680a239dc1ed58c8e
+config_hash: 7caf94f26186e1ee432efcaa0b590bab

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.9.0 (2026-07-06)
+
+Full Changelog: [v4.8.0...v4.9.0](https://github.com/runwayml/sdk-node/compare/v4.8.0...v4.9.0)
+
+### Features
+
+* **api:** add ad_localization recipe ([85101d8](https://github.com/runwayml/sdk-node/commit/85101d8c177a9053b631238adaabb3d38875dfaa))
+
 ## 4.8.0 (2026-07-06)
 
 Full Changelog: [v4.7.0...v4.8.0](https://github.com/runwayml/sdk-node/compare/v4.7.0...v4.8.0)

api.md

@@ -216,6 +216,7 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/recipes.ts">RecipeAdLocalizationResponse</a></code>
 - <code><a href="./src/resources/recipes.ts">RecipeMarketingStockImageResponse</a></code>
 - <code><a href="./src/resources/recipes.ts">RecipeMultiShotVideoResponse</a></code>
 - <code><a href="./src/resources/recipes.ts">RecipeProductAdResponse</a></code>
@@ -225,6 +226,7 @@ Types:
 
 Methods:
 
+- <code title="post /v1/recipes/ad_localization">client.recipes.<a href="./src/resources/recipes.ts">adLocalization</a>({ ...params }) -> RecipeAdLocalizationResponse</code>
 - <code title="post /v1/recipes/marketing_stock_image">client.recipes.<a href="./src/resources/recipes.ts">marketingStockImage</a>({ ...params }) -> RecipeMarketingStockImageResponse</code>
 - <code title="post /v1/recipes/multi_shot_video">client.recipes.<a href="./src/resources/recipes.ts">multiShotVideo</a>({ ...params }) -> RecipeMultiShotVideoResponse</code>
 - <code title="post /v1/recipes/product_ad">client.recipes.<a href="./src/resources/recipes.ts">productAd</a>({ ...params }) -> RecipeProductAdResponse</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runwayml/sdk",
-  "version": "4.8.0",
+  "version": "4.9.0",
   "description": "The official TypeScript library for the RunwayML API",
   "author": "RunwayML <dev-feedback@runwayml.com>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -78,6 +78,8 @@ import {
   RealtimeSessions,
 } from './resources/realtime-sessions';
 import {
+  RecipeAdLocalizationParams,
+  RecipeAdLocalizationResponse,
   RecipeMarketingStockImageParams,
   RecipeMarketingStockImageResponse,
   RecipeMultiShotVideoParams,
@@ -1133,12 +1135,14 @@ export declare namespace RunwayML {
 
   export {
     Recipes as Recipes,
+    type RecipeAdLocalizationResponse as RecipeAdLocalizationResponse,
     type RecipeMarketingStockImageResponse as RecipeMarketingStockImageResponse,
     type RecipeMultiShotVideoResponse as RecipeMultiShotVideoResponse,
     type RecipeProductAdResponse as RecipeProductAdResponse,
     type RecipeProductCampaignImageResponse as RecipeProductCampaignImageResponse,
     type RecipeProductSwapResponse as RecipeProductSwapResponse,
     type RecipeProductUgcResponse as RecipeProductUgcResponse,
+    type RecipeAdLocalizationParams as RecipeAdLocalizationParams,
     type RecipeMarketingStockImageParams as RecipeMarketingStockImageParams,
     type RecipeMultiShotVideoParams as RecipeMultiShotVideoParams,
     type RecipeProductAdParams as RecipeProductAdParams,

src/resources/index.ts

@@ -60,12 +60,14 @@ export {
 } from './realtime-sessions';
 export {
   Recipes,
+  type RecipeAdLocalizationResponse,
   type RecipeMarketingStockImageResponse,
   type RecipeMultiShotVideoResponse,
   type RecipeProductAdResponse,
   type RecipeProductCampaignImageResponse,
   type RecipeProductSwapResponse,
   type RecipeProductUgcResponse,
+  type RecipeAdLocalizationParams,
   type RecipeMarketingStockImageParams,
   type RecipeMultiShotVideoParams,
   type RecipeProductAdParams,

src/resources/recipes.ts

@@ -5,6 +5,19 @@ import { RequestOptions } from '../internal/request-options';
 import { APIPromiseWithAwaitableTask, wrapAsWaitableResource } from '../lib/polling';
 
 export class Recipes extends APIResource {
+  /**
+   * Localize an existing ad image for a target language, preserving visual creative
+   * while adapting on-screen messaging.
+   */
+  adLocalization(
+    body: RecipeAdLocalizationParams,
+    options?: RequestOptions,
+  ): APIPromiseWithAwaitableTask<RecipeAdLocalizationResponse> {
+    return wrapAsWaitableResource<RecipeAdLocalizationResponse>(this._client)(
+      this._client.post('/v1/recipes/ad_localization', { body, ...options }),
+    );
+  }
+
   /**
    * Generate a polished marketing stock image from a text brief and optional brand
    * logo image.
@@ -83,6 +96,13 @@ export class Recipes extends APIResource {
   }
 }
 
+export interface RecipeAdLocalizationResponse {
+  /**
+   * The ID of the task that was created. Use this to retrieve the task later.
+   */
+  id: string;
+}
+
 export interface RecipeMarketingStockImageResponse {
   /**
    * The ID of the task that was created. Use this to retrieve the task later.
@@ -125,6 +145,61 @@ export interface RecipeProductUgcResponse {
   id: string;
 }
 
+export interface RecipeAdLocalizationParams {
+  /**
+   * Reference ad image to localize. See [our docs](/assets/inputs#images) on image
+   * inputs.
+   */
+  referenceImage: RecipeAdLocalizationParams.ReferenceImage;
+
+  /**
+   * Target language for the localized ad. Use ISO-style codes (e.g. "ja" for
+   * Japanese, "es" for Spanish).
+   */
+  targetLanguage:
+    | 'ar'
+    | 'zh'
+    | 'zh-Hant'
+    | 'nl'
+    | 'en'
+    | 'fr'
+    | 'de'
+    | 'hi'
+    | 'id'
+    | 'it'
+    | 'ja'
+    | 'ko'
+    | 'pl'
+    | 'pt'
+    | 'ru'
+    | 'es'
+    | 'sv'
+    | 'th'
+    | 'tr'
+    | 'uk'
+    | 'vi'
+    | 'el';
+
+  /**
+   * 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).
+   */
+  version: '2026-06' | 'unsafe-latest';
+}
+
+export namespace RecipeAdLocalizationParams {
+  /**
+   * Reference ad image to localize. See [our docs](/assets/inputs#images) on image
+   * inputs.
+   */
+  export interface ReferenceImage {
+    /**
+     * A HTTPS URL.
+     */
+    uri: string;
+  }
+}
+
 export interface RecipeMarketingStockImageParams {
   /**
    * Marketing image brief. Describe the subject, audience, channel, desired mood,
@@ -561,12 +636,14 @@ export namespace RecipeProductUgcParams {
 
 export declare namespace Recipes {
   export {
+    type RecipeAdLocalizationResponse as RecipeAdLocalizationResponse,
     type RecipeMarketingStockImageResponse as RecipeMarketingStockImageResponse,
     type RecipeMultiShotVideoResponse as RecipeMultiShotVideoResponse,
     type RecipeProductAdResponse as RecipeProductAdResponse,
     type RecipeProductCampaignImageResponse as RecipeProductCampaignImageResponse,
     type RecipeProductSwapResponse as RecipeProductSwapResponse,
     type RecipeProductUgcResponse as RecipeProductUgcResponse,
+    type RecipeAdLocalizationParams as RecipeAdLocalizationParams,
     type RecipeMarketingStockImageParams as RecipeMarketingStockImageParams,
     type RecipeMultiShotVideoParams as RecipeMultiShotVideoParams,
     type RecipeProductAdParams as RecipeProductAdParams,

src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.8.0'; // x-release-please-version
+export const VERSION = '4.9.0'; // x-release-please-version

tests/api-resources/recipes.test.ts

@@ -8,6 +8,29 @@ const client = new RunwayML({
 });
 
 describe('resource recipes', () => {
+  test('adLocalization: only required params', async () => {
+    const responsePromise = client.recipes.adLocalization({
+      referenceImage: { uri: 'https://example.com/file' },
+      targetLanguage: 'ar',
+      version: '2026-06',
+    });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('adLocalization: required and optional params', async () => {
+    const response = await client.recipes.adLocalization({
+      referenceImage: { uri: 'https://example.com/file' },
+      targetLanguage: 'ar',
+      version: '2026-06',
+    });
+  });
+
   test('marketingStockImage: only required params', async () => {
     const responsePromise = client.recipes.marketingStockImage({ prompt: 'x', version: '2026-06' });
     const rawResponse = await responsePromise.asResponse();