v50

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

Recipes

Create a marketing stock image

Generate a polished marketing stock image from a text brief and optional brand logo image.

post/v1/recipes/marketing_stock_image

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).

promptstring required

Marketing image brief. Describe the subject, audience, channel, desired mood, setting, and any constraints.

outputCountinteger

The number of images to generate (1-4). Defaults to 4. Increasing this number affects credits consumed.

quality'low' | 'medium' | 'high'

GPT Image 2 rendering quality (low, medium, or high). Lower settings are faster and use fewer credits; high (default) is slowest and highest fidelity.

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.