Create Predictions - Generale

POST /replicate/v1/models//predictions crea immagini FLUX tramite il formato Replicate su CometAPI, con aspect ratio, quality, formato di output e ottimizzazione dell’input.

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"
  }
}

Usa questa route per avviare una prediction in stile Replicate su CometAPI e ottenere un prediction id da interrogare successivamente.

​

Checklist della prima richiesta

• Inserisci ogni parametro del model all’interno dell’oggetto input
• Inizia con black-forest-labs/flux-schnell per il test iniziale più leggero
• Mantieni la prima richiesta solo testuale, a meno che tu non abbia bisogno specificamente di input_image o input_images
• Salva il valore id restituito per i controlli dello stato

​

Flusso dell’attività

1. Crea la prediction

   Invia il model id nel path e l’oggetto input tramite questo endpoint.

2. Memorizza il prediction id

   Salva il valore id restituito, perché ti servirà per le interrogazioni successive.

3. Interroga la prediction

   Continua con Replicate Query Status finché output non viene popolato o compare un errore.

La validazione live del 2026-03-12 ha confermato che black-forest-labs/flux-schnell ha accettato una richiesta solo testuale e ha restituito un prediction id con stato starting.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Parametri del percorso

models · string · obbligatorio

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

Corpo

application/json

input · object · obbligatorio

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

Show child attributes

Risposta

200 - application/json

Prediction accepted.

id · string · obbligatorio

model · string · obbligatorio

input · object · obbligatorio

output · string[] | null · obbligatorio

error · string | null · obbligatorio

status · string · obbligatorio

created_at · string · obbligatorio

urls · object · obbligatorio

Show child attributes

version · string

logs · string

data_removed · boolean

source · string