text-to-image

Create image from text - RunWay

Generate high-quality images from text descriptions using RunWay's Gen4 Image model.

Key Features:

  • Photorealistic and artistic image generation
  • Multiple aspect ratios supported
  • Reference image support with @tag syntax
  • High-resolution output

Best for:

  • Photorealistic images
  • Artistic and creative visuals
  • Marketing and promotional content
post/v1/ai/text-to-image/runway

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/text-to-image/runway
  • Auth: API key in header x-magnific-api-key

Request body

promptstring required

Text prompt describing the desired image.

Tips:

  • Be specific about visual details and composition
  • RunWay excels at photorealistic and artistic images
  • Reference images can be used with @tag syntax

Examples:

  • Simple: "A serene mountain landscape at sunset"
  • Detailed: "A majestic lion in the savanna at golden hour, cinematic lighting"
ratio'1920:1080' | '1080:1920' | '1024:1024' | '1360:768' | '1080:1080' | '1168:880' | '1440:1080' | '1080:1440' | '1808:768' | '2112:912' | '1280:720' | '720:1280' | '720:720' | '960:720' | '720:960' | '1680:720' required

Image aspect ratio (width:height).

Available ratios:

  • 1920:1080: Landscape (16:9)
  • 1080:1920: Portrait (9:16)
  • 1024:1024: Square
  • 1280:720: HD Landscape
  • 720:1280: HD Portrait
seedinteger

Random seed for reproducibility. Using the same seed with identical parameters produces the same image.

webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example request

{
  "prompt": "A serene mountain landscape at sunset with golden light",
  "ratio": "1920:1080",
  "seed": 12345,
  "webhook_url": "https://www.example.com/webhook"
}

Response

OK - The request has succeeded and the RunWay process has started.

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.