Create Predictions - General

POST /replicate/v1/models//predictions creates FLUX images via Replicate format on CometAPI, with aspect ratio, quality, output format, and input tuning.

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

Create a Replicate prediction

cURL

curl --request POST \
  --url https://api.cometapi.com/replicate/v1/models/{models}/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": {
    "prompt": "A paper boat floating on calm water at sunrise.",
    "aspect_ratio": "1:1",
    "output_format": "webp",
    "output_quality": 80
  }
}
'

200

{
  "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 lightest smoke test
• 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 Replicate Query Status until output is populated or an error appears.

Live validation on 2026-03-12 confirmed that black-forest-labs/flux-schnell accepted a text-only request and returned a prediction id with status starting.

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.

Show child attributes

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

Show child attributes

version · string

logs · string

data_removed · boolean

source · string