---
title: "Create image from text - RunWay"
method: POST
path: "/v1/ai/text-to-image/runway"
tags: ["text-to-image"]
---

# Create image from text - RunWay

`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`

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

## Request body

- TtirunwayRequestContent
  - `prompt` string, 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
  - `seed` integer: Random seed for reproducibility. Using the same seed with identical parameters produces the same image.
  - `webhook_url` string, 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.

## Response `200`

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

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)