Video Generation

Runway Gen-4.5 API

Runway's Gen-4.5 video model. Text-to-video or image-to-video at 720p in five shapes, 5, 8 or 10 seconds, with cinematic camera work and believable motion. Clips are silent. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Credit Cost

20 credits

Type

Video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/runway-gen-4-5/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/runway-gen-4-5.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	What happens in the clip. One shot per prompt: subject, action, camera move, style. Up to 1000 characters.	-
`image`	url	Optional first frame for image-to-video. The clip starts from this image.	-
`aspect_ratio`	enum	Output shape, always 720p. Without a start image only 16:9 and 9:16 are accepted; with a start image all five work. `16:99:164:33:41:1`	`16:9`
`duration`	enum	Clip length in seconds: 5, 8 or 10. `5810`	`5`
`seed`	integer	Optional seed for repeatable results. min: 0 \| max: 4294967295	-

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Supported Aspect Ratios

16:9

9:16

4:3

3:4

1:1

Code Examples

Text → video: copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/runway-gen-4-5/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A handsome detective in a trench coat lights a cigarette in a rain-soaked alley, slow push in, film noir, hard shadows",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 20,
  "creditsRemaining": 95,
  "expiresAt": "2026-11-15T00:14:46Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 20,
  "expiresAt": "2026-11-15T00:14:46Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits