Recipes

Create a marketing stock image

Changed on

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

post/v1/recipes/marketing_stock_image

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/recipes/marketing_stock_image
  • Auth
    HTTP bearer

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.

Changes

  • ef7e1923afafRevision changes
    • info

      added the optional property to the response with the status

  • 73a12c23285cRevision changes
    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status