---
title: "Create a Replicate prediction"
method: POST
path: "/replicate/v1/models/{models}/predictions"
---

# Create a Replicate prediction

`POST /replicate/v1/models/{models}/predictions`

Submit a prediction request using a model id in the path and a provider-specific `input` object in the body.

## Path parameters

- `models` string, required

## Request body

- object
  - `input` object, required — Provider-specific model input. Keep all parameters inside this object.
    - `prompt` string, required
    - `aspect_ratio` string — Common aspect ratios supported by many FLUX models, for example `1:1`, `16:9`, `9:16`, `3:2`, or `2:3`.
    - `output_format` 'webp' | 'png' | 'jpg' | 'jpeg'
    - `output_quality` integer
    - `input_image` string — Single reference image URL or provider-supported image input for edit or context-aware models such as `flux-kontext-pro`.
    - `input_images` string[] — Multiple reference images when the selected Replicate-compatible model supports them.

## Response `200`

Prediction accepted.

- object
  - `id` string, required
  - `model` string, required
  - `version` string
  - `input` object, required
  - `logs` string
  - `output` string[], nullable, required
  - `data_removed` boolean
  - `error` string, nullable, required
  - `source` string
  - `status` string, required
  - `created_at` string, required
  - `urls` object, required
    - `cancel` string
    - `get` string
    - `stream` string
    - `web` string

---

[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)