Skip to main content
POST
/
runway
/
pro
/
generate
cURL
curl https://api.deerapi.com/runway/pro/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "callback_url": "https://your-server.com/callback",
    "ratio": "16:9",
    "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
    "style": "cinematic",
    "model": "gen4_turbo",
    "options": {
      "seconds": 10,
      "motion_vector": {
        "x": 0,
        "y": 0.4,
        "z": 0,
        "r": -6,
        "bg_x_pan": 0,
        "bg_y_pan": 0
      }
    }
  }'

{
  "code": 200,
  "msg": "Request accepted.",
  "data": {
    "task_id": "221c136d-7888-43c3-acd3-1fcc90d51cfd",
    "state": "",
    "status": "0",
    "prompt": "",
    "prompt_en": null,
    "video_url": null,
    "raw_video_url": null,
    "poster": null,
    "last_frame": null,
    "msg": null,
    "create_time": "0",
    "update_time": "0"
  },
  "exec_time": 0
}

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.

​
Overview

Use this endpoint to call the Runway Generate 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: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. 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.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

Headers

​
X-Runway-Version
string

Body

application/json
​
callback_url
string
default:example
required

Use this field according to the endpoint schema.

​
ratio
string
default:example
required

Use this field according to the endpoint schema.

​
prompt
string
default:Hello
required

Use this field according to the endpoint schema.

​
style
string
default:example
required

Use this field according to the endpoint schema.

​
model
string
default:gen4_turbo
required

Use this field according to the endpoint schema.

​
options
object
required

Use this field according to the endpoint schema.

Response

200 - application/json

OK

​
code
integer
required

Use this field according to the endpoint schema.

​
msg
string
required

Use this field according to the endpoint schema.

​
data
object
required
​
exec_time
number
required

Use this field according to the endpoint schema.