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

# Runway API overview

> Choose a Runway image, video, or audio model and its CometAPI endpoint, then retrieve the task result.

Use Runway models through CometAPI to generate images, create or edit video,
produce speech and sound effects, or process audio. Every creation request
returns a task `id`; use the task endpoint to retrieve status and output URLs.

## Choose a model and endpoint

The following models are available through these Runway endpoints. Each
linked reference describes the parameters for its models.

| Task                                   | Model IDs                                           | Endpoint                                                          |
| -------------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------- |
| Generate an image                      | `gen4_image`, `gen4_image_turbo`                    | [Text to image](./official-format/generate-an-image-from-text)    |
| Animate an image                       | `gen4.5`, `gen4_turbo`                              | [Image to video](./official-format/runway-images-raw-video)       |
| Generate a video from text             | `gen4.5`                                            | [Text to video](./official-format/generate-a-video-from-text)     |
| Edit a video                           | `aleph2`                                            | [Video to video](./official-format/generate-a-video-from-a-video) |
| Animate a character from a performance | `act_two`                                           | [Character performance](./official-format/control-a-character)    |
| Upscale a video                        | `magnific_video_upscaler_creative`                  | [Video upscale](./official-format/upscale-a-video)                |
| Generate sound effects                 | `eleven_text_to_sound_v2`, `seed_audio`             | [Sound effects](./official-format/generate-sound-effects)         |
| Generate speech from text              | `eleven_multilingual_v2`, `eleven_v3`, `seed_audio` | [Text to speech](./official-format/generate-speech-from-text)     |
| Convert a voice                        | `eleven_multilingual_sts_v2`                        | [Speech to speech](./official-format/convert-speech)              |
| Dub audio into another language        | `eleven_voice_dubbing`                              | [Voice dubbing](./official-format/dub-audio)                      |
| Separate speech from background audio  | `eleven_voice_isolation`                            | [Voice isolation](./official-format/isolate-voice)                |

`gen4.5` supports both text-to-video and image-to-video requests.
`gen4_turbo` uses image-to-video requests. `seed_audio` has different input
fields for sound effects and text-to-speech; follow the selected endpoint's
model variant.

## Create a task and retrieve the result

<Steps>
  <Step title="Choose the endpoint and model">
    Select the task above, then use the model-specific request schema and
    example on that endpoint page.
  </Step>

  <Step title="Send the request">
    [Store your API key locally](/overview/quick-start#store-your-api-key-locally)
    as `$COMETAPI_KEY` before running the examples.
    Send JSON to `https://api.cometapi.com/runwayml/v1` followed by the
    endpoint path. Authenticate with `Authorization: Bearer <COMETAPI_KEY>`.
  </Step>

  <Step title="Save the task ID">
    Save the returned `id` for the task-retrieval request.
  </Step>

  <Step title="Retrieve the output">
    Use [Get a Runway task](./official-format/runway-to-get-task-details)
    with an API key from the same CometAPI account. When `status` is
    `SUCCEEDED`, download the assets listed in `output` and store them.
  </Step>
</Steps>

For media inputs, use accessible HTTPS URLs or the data URI format shown in
the endpoint schema. Replace example media URLs with your own inputs when
the example calls for a source video or audio file.