Skip to main content
POST
/
replicate
/
v1
/
models
/
{models}
/
predictions
cURL
curl https://api.cometapi.com/replicate/v1/models/black-forest-labs/flux-schnell/predictions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "A paper boat floating on calm water at sunrise.",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }'
{
  "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"
  }
}
Use this route to start a Replicate-style prediction on CometAPI and get back a prediction id for later polling.

​
First request checklist

  • Put every model parameter inside the input object
  • Start with black-forest-labs/flux-schnell for the quickest first request
  • Keep the first request text-only unless you specifically need input_image or input_images
  • Save the returned prediction id for status checks

​
Task flow

1

Create the prediction

Submit the path model id and the input object through this endpoint.
2

Store the prediction id

Save the returned id, because you need it for later polling.
3

Poll the prediction

Continue with Get a Replicate prediction until output is populated or an error appears.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

​
models
string
required

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

Body

application/json
​
input
object
required

Provider-specific model input. Keep all parameters inside this object.

Response

200 - application/json

Prediction accepted.

​
id
string
required
​
model
string
required
​
input
object
required
​
output
string[] | null
required
​
error
string | null
required
​
status
string
required
​
created_at
string
required
​
urls
object
required
​
version
string
​
logs
string
​
data_removed
boolean
​
source
string