---
title: "Create a Runway image-generation task"
method: POST
path: "/runwayml/v1/text_to_image"
---

# Create a Runway image-generation task

`POST /runwayml/v1/text_to_image`

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

## Headers

- `X-Runway-Version` string, required

## Request body

- object
  - `promptText` string, required — A non-empty string up to 1000 characters.
  - `ratio` string, required — Aspect ratio of the output image, e.g. `1280:720`.
  - `seed` integer, required — Random seed for reproducible results.
  - `model` string, required — The model variant to use.
  - `referenceImages` object[], required — An array of up to three images to be used as references. At least one item is required. `referenceImages` is required.
    - `uri` string
    - `tag` string
  - `contentModeration` object, required
    - `publicFigureThreshold` string, required — Threshold for public-figure detection. Use `auto` for default behavior.

## Response `200`

Task accepted.

- object
  - `id` string, required

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)