---
title: "Generate with Reference Image API"
method: POST
path: "/runway/pro/generate"
---

# Generate with Reference Image API

`POST /runway/pro/generate`

## Headers

- `X-Runway-Version` string

## Request body

- object
  - `callback_url` string, required — Use this field according to the endpoint schema.
  - `ratio` string, required — Use this field according to the endpoint schema.
  - `prompt` string, required — Use this field according to the endpoint schema.
  - `style` string — Use this field according to the endpoint schema.
  - `model` string, required — Use this field according to the endpoint schema.
  - `options` object — Use this field according to the endpoint schema.
    - `seconds` integer — Use this field according to the endpoint schema.
    - `motion_vector` object — Use this field according to the endpoint schema.
      - `x` number — Use this field according to the endpoint schema.
      - `y` integer — Use this field according to the endpoint schema.
      - `z` integer — Use this field according to the endpoint schema.
      - `r` integer — Use this field according to the endpoint schema.
      - `bg_x_pan` integer — Use this field according to the endpoint schema.
      - `bg_y_pan` integer — Use this field according to the endpoint schema.
    - `image_as_end_frame` boolean — Use this field according to the endpoint schema.
    - `flip` boolean — Use this field according to the endpoint schema.
  - `image` string, required — Use this field according to the endpoint schema.
  - `last_image` string — Use this field according to the endpoint schema.

## Response `200`

OK

- object
  - `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
    - `task_id` string, required — Use this field according to the endpoint schema.
    - `state` string, nullable — Use this field according to the endpoint schema.
    - `status` string, nullable — Use this field according to the endpoint schema.
    - `prompt` string, nullable — Use this field according to the endpoint schema.
    - `prompt_en` string, nullable — Use this field according to the endpoint schema.
    - `video_url` string, nullable — Use this field according to the endpoint schema.
    - `raw_video_url` string, nullable — Use this field according to the endpoint schema.
    - `poster` string, nullable — Use this field according to the endpoint schema.
    - `last_frame` string, nullable — Use this field according to the endpoint schema.
    - `msg` string, nullable — Use this field according to the endpoint schema.
    - `point` string, nullable
    - `refund` string, nullable
    - `create_time` string, nullable — Use this field according to the endpoint schema.
    - `update_time` string, nullable — Use this field according to the endpoint schema.
  - `exec_time` number, required — Use this field according to the endpoint schema.

---

[API](https://skmtc.net/deerapi/apis/text-to-audio-api.md) · [All operations](https://skmtc.net/deerapi/apis/text-to-audio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deerapi/text-to-audio-api/versions/b6265ced74a1/schema)