---
title: "RunWay Gen4 Turbo - Create video from image"
method: POST
path: "/v1/ai/image-to-video/runway-gen4-turbo"
tags: ["image-to-video"]
---

# RunWay Gen4 Turbo - Create video from image

`POST /v1/ai/image-to-video/runway-gen4-turbo`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/image-to-video/runway-gen4-turbo`
- Auth: API key in header `x-magnific-api-key`

Generate a video from an image using RunWay Gen4 Turbo model.

## Request body

- RunwayGen4TurboRequest
  - `webhook_url` string, uri: Webhook URL to notify the user when the task is completed
  - `image` string, required: Reference image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).
  - `ratio` '1280:720' | '720:1280' | '1104:832' | '832:1104' | '960:960' | '1584:672': Aspect ratio for the generated video (width:height)
  - `duration` 5 | 10: Duration of the generated video in seconds
  - `prompt` string: Text prompt describing what should appear in the video (1-1000 characters)
  - `seed` integer: Random seed for reproducibility

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