v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Runway image-generation task

Submit the prompt, ratio, model, and at least one referenceImages object.

post/runwayml/v1/text_to_image

X-Runway-Versionstring required

Runway version header, for example 2024-11-06.

promptTextstring required

A non-empty string up to 1000 characters.

ratiostring required

Aspect ratio of the output image, e.g. 1280:720.

seedinteger required

Random seed for reproducible results.

modelstring required

The model variant to use.

Task accepted.

idstring required

{
  "id": "31f9c5b2-ea5c-421c-8044-75a6bb53211d"
}