---
title: "Create video from text - RunWay Gen 4.5"
method: POST
path: "/v1/ai/text-to-video/runway-4-5"
tags: ["text-to-video"]
---

# Create video from text - RunWay Gen 4.5

`POST /v1/ai/text-to-video/runway-4-5`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-video/runway-4-5`
- Auth: API key in header `x-magnific-api-key`

Generate high-quality videos from text descriptions using RunWay Gen 4.5 model.

**Features:**
- State-of-the-art text-to-video generation
- Multiple aspect ratios for different use cases
- Duration options: 5, 8, or 10 seconds
- High visual fidelity and motion quality

**Supported aspect ratios:**
- `1280:720`: Landscape (16:9) - ideal for YouTube, presentations
- `720:1280`: Portrait (9:16) - ideal for TikTok, Instagram Reels
- `1104:832`: Landscape (4:3) - classic format
- `960:960`: Square (1:1) - ideal for Instagram posts
- `832:1104`: Portrait (3:4) - ideal for Pinterest

**Use cases:** Social media content, marketing videos, creative projects, and visual storytelling.

## Request body

- T2vRequest3
  - `webhook_url` string, uri: Webhook URL to notify when the task is completed
  - `prompt` string, required: Text prompt describing the video to generate. Maximum 2000 characters.
  - `ratio` '1280:720' | '720:1280' | '1104:832' | '960:960' | '832:1104': Aspect ratio of the generated video. - `1280:720`: Landscape (16:9) - `720:1280`: Portrait (9:16) - `1104:832`: Landscape (4:3) - `960:960`: Square (1:1) - `832:1104`: Portrait (3:4)
  - `duration` 5 | 8 | 10: Duration of the generated video in seconds (5, 8, or 10).

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, 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)
