Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Replicate prediction

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

post/replicate/v1/models/{models}/predictions

Path parameters

modelsstring required

Replicate model id, for example black-forest-labs/flux-schnell or black-forest-labs/flux-kontext-pro.

Request body

Response

Prediction accepted.

idstring required
modelstring required
versionstring
inputobject required
logsstring
outputstring[] nullable required
data_removedboolean
errorstring nullable required
sourcestring
statusstring required
created_atstring required

Example response

{
  "id": "q4chw5rey9rmt0cww76t4h3ma4",
  "model": "black-forest-labs/flux-schnell",
  "version": "hidden",
  "input": {
    "aspect_ratio": "1:1",
    "output_format": "webp",
    "output_quality": 80,
    "prompt": "A paper boat floating on calm water at sunrise."
  },
  "logs": "",
  "output": null,
  "data_removed": false,
  "error": null,
  "source": "api",
  "status": "starting",
  "created_at": "2026-03-12T11:27:18.258Z",
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/q4chw5rey9rmt0cww76t4h3ma4/cancel",
    "get": "https://api.replicate.com/v1/predictions/q4chw5rey9rmt0cww76t4h3ma4",
    "stream": "https://stream.replicate.com/v1/files/example",
    "web": "https://replicate.com/p/q4chw5rey9rmt0cww76t4h3ma4"
  }
}