> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyaskr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Runway

> Cinematic video generation and video-to-video.

Runway is a video family built for a cinematic look, with strong text-to-video
and video-to-video. Reach for it when style and control matter.

## Best for

* Cinematic, stylised generation.
* Video-to-video restyling.
* Creative and marketing work.

|                      |                                           |
| -------------------- | ----------------------------------------- |
| **Modality**         | Video (text/image/video in, video out)    |
| **Example model id** | `runway-gen-4`                            |
| **Endpoint**         | `POST /v1/videos` (async submit-and-poll) |

## Example

Video generation is **asynchronous**: submit a job, then poll for the result.

<Steps>
  <Step title="Submit a job">
    ```bash theme={null}
    curl https://api.heyaskr.ai/v1/videos \
      -H "Authorization: Bearer ASKR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "runway-gen-4",
        "prompt": "a neon city street at night, cinematic dolly shot",
        "aspect_ratio": "16:9",
        "duration": "5"
      }'
    ```

    The response returns a job `id`, an `estimated_cost`, and `status: "pending"`.
  </Step>

  <Step title="Poll for the result">
    ```bash theme={null}
    curl https://api.heyaskr.ai/v1/videos/JOB_ID \
      -H "Authorization: Bearer ASKR_API_KEY"
    ```

    Poll every 5–10 seconds until `status` is `completed` (the response includes
    the video URL) or `failed`.
  </Step>
</Steps>

## Pricing

Priced per second of output. As a rough guide, expect around **\$0.15 per second**,
so a 5-second clip is about **\$0.75**. You're only charged when a job completes.

<div className="askr-img-placeholder">
  <span><strong>Image</strong><br />Runway sample output: a still frame from a generated clip</span>
</div>

<Note>
  The model id and prices above are examples. Confirm the exact id and current
  price against the live [`/v1/models`](/api-reference/list-models) list before you
  rely on them.
</Note>