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

# Runway Image To Video

> Use DeerAPI to call the Runway Image To Video endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Runway Image To Video workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/video/runway/official/post-image-to-video.openapi.json POST /runwayml/v1/image_to_video
openapi: 3.1.0
info:
  title: Runway Image to Video API
  version: 1.0.0
  description: Use this field according to the endpoint schema.
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /runwayml/v1/image_to_video:
    post:
      summary: Runway Image to Video API
      description: Use this field according to the endpoint schema.
      operationId: runway_official_image_to_video
      parameters:
        - name: X-Runway-Version
          in: header
          required: true
          description: Use this field according to the endpoint schema.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - promptImage
                - model
              properties:
                promptImage:
                  type: string
                  description: Use this field according to the endpoint schema.
                seed:
                  type: integer
                  description: Use this field according to the endpoint schema.
                model:
                  type: string
                  description: Use this field according to the endpoint schema.
                  default: gen3a_turbo
                promptText:
                  type: string
                  description: Use this field according to the endpoint schema.
                watermark:
                  type: boolean
                  description: Use this field according to the endpoint schema.
                  default: false
                duration:
                  type: integer
                  description: Use this field according to the endpoint schema.
                  default: 5
                ratio:
                  type: string
                  description: Use this field according to the endpoint schema.
                  enum:
                    - '1280:720'
                    - '720:1280'
                    - '1104:832'
                    - '832:1104'
                    - '960:960'
                    - '1584:672'
                    - '1280:768'
                    - '768:1280'
                  default: '1280:720'
            examples:
              Default:
                summary: Runway Image to Video API
                value:
                  promptImage: >-
                    https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
                  seed: 1
                  model: gen3a_turbo
                  promptText: A calm camera move.
                  watermark: false
                  duration: 5
                  ratio: '1280:768'
            example:
              promptImage: >-
                https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
              seed: 1
              model: gen3a_turbo
              promptText: A calm camera move.
              watermark: false
              duration: 5
              ratio: '1280:768'
      responses:
        '200':
          description: Use this field according to the endpoint schema.
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
                    description: Use this field according to the endpoint schema.
                example:
                  id: 4534fbe1-effa-4a12-b401-02923dace753
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/runwayml/v1/image_to_video \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
                "seed": 1,
                "model": "gen3a_turbo",
                "promptText": "A calm camera move.",
                "watermark": false,
                "duration": 5,
                "ratio": "1280:768"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/runwayml/v1/image_to_video"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
              "seed": 1,
              "model": "gen3a_turbo",
              "promptText": "A calm camera move.",
              "watermark": false,
              "duration": 5,
              "ratio": "1280:768"
            }

            response = requests.post(url, headers=headers, json=payload)
            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/runwayml/v1/image_to_video", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
                "seed": 1,
                "model": "gen3a_turbo",
                "promptText": "A calm camera move.",
                "watermark": false,
                "duration": 5,
                "ratio": "1280:768"
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````