> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une prédiction Replicate

> POST /replicate/v1/models/{models}/predictions crée des images FLUX via le format Replicate sur CometAPI, avec ratio d’aspect, qualité, format de sortie et ajustement des entrées.

Utilisez cette route pour lancer une prédiction de type Replicate sur CometAPI et récupérer un id de prédiction pour une interrogation ultérieure.

## Checklist de la première requête

* Placez chaque paramètre du modèle dans l’objet `input`
* Commencez avec `black-forest-labs/flux-schnell` pour la première requête la plus rapide
* Gardez la première requête en texte uniquement, sauf si vous avez spécifiquement besoin de `input_image` ou `input_images`
* Enregistrez l’`id` de prédiction renvoyé pour les vérifications de statut

## Flux de la tâche

<Steps>
  <Step title="Créer la prédiction">
    Envoyez le model ID du chemin et l’objet `input` via ce endpoint.
  </Step>

  <Step title="Stocker l’id de prédiction">
    Enregistrez l’`id` renvoyé, car vous en aurez besoin pour l’interrogation ultérieure.
  </Step>

  <Step title="Interroger la prédiction">
    Continuez avec [Obtenir une prédiction Replicate](./replicate-query) jusqu’à ce que `output` soit renseigné ou qu’une erreur apparaisse.
  </Step>
</Steps>


## OpenAPI

````yaml api/openapi/image/replicate/post-create-predictions-general.openapi.json POST /replicate/v1/models/{models}/predictions
openapi: 3.1.0
info:
  title: Create Predictions - General API
  version: 1.0.0
  description: >-
    Create a Replicate-style prediction on CometAPI and receive a prediction id
    for later polling.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /replicate/v1/models/{models}/predictions:
    post:
      summary: Create a Replicate prediction
      description: >-
        Submit a prediction request using a model id in the path and a
        provider-specific `input` object in the body.
      operationId: create_predictions_general
      parameters:
        - name: models
          in: path
          required: true
          description: >-
            Replicate model id, for example `black-forest-labs/flux-schnell` or
            `black-forest-labs/flux-kontext-pro`.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  type: object
                  description: >-
                    Provider-specific model input. Keep all parameters inside
                    this object.
                  required:
                    - prompt
                  properties:
                    prompt:
                      type: string
                    aspect_ratio:
                      type: string
                      description: >-
                        Common aspect ratios supported by many FLUX models, for
                        example `1:1`, `16:9`, `9:16`, `3:2`, or `2:3`.
                    output_format:
                      type: string
                      enum:
                        - webp
                        - png
                        - jpg
                        - jpeg
                    output_quality:
                      type: integer
                      minimum: 1
                      maximum: 100
                    input_image:
                      type: string
                      description: >-
                        Single reference image URL or provider-supported image
                        input for edit or context-aware models such as
                        `flux-kontext-pro`.
                    input_images:
                      type: array
                      description: >-
                        Multiple reference images when the selected
                        Replicate-compatible model supports them.
                      items:
                        type: string
              default:
                input:
                  prompt: A paper boat floating on calm water at sunrise.
                  aspect_ratio: '1:1'
                  output_format: webp
                  output_quality: 80
            examples:
              Validated text-only request:
                summary: Validated text-only request
                value:
                  input:
                    prompt: A paper boat floating on calm water at sunrise.
                    aspect_ratio: '1:1'
                    output_format: webp
                    output_quality: 80
      responses:
        '200':
          description: Prediction accepted.
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - model
                  - input
                  - output
                  - error
                  - status
                  - created_at
                  - urls
                properties:
                  id:
                    type: string
                  model:
                    type: string
                  version:
                    type: string
                  input:
                    type: object
                  logs:
                    type: string
                  output:
                    type:
                      - array
                      - 'null'
                    items:
                      type: string
                  data_removed:
                    type: boolean
                  error:
                    type:
                      - string
                      - 'null'
                  source:
                    type: string
                  status:
                    type: string
                  created_at:
                    type: string
                  urls:
                    type: object
                    properties:
                      cancel:
                        type: string
                      get:
                        type: string
                      stream:
                        type: string
                      web:
                        type: string
                example:
                  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
      x-codeSamples:
        - lang: Shell
          label: Default
          source: >
            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"
                }
              }'
        - lang: Python
          label: Default
          source: >
            import os

            import requests


            response = requests.post(
                "https://api.cometapi.com/replicate/v1/models/black-forest-labs/flux-schnell/predictions",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                json={
                    "input": {
                        "prompt": "A paper boat floating on calm water at sunrise.",
                        "aspect_ratio": "1:1",
                        "output_format": "webp",
                    }
                },
            )


            prediction = response.json()

            print(prediction["id"], prediction["status"])  # poll GET
            /replicate/v1/predictions/{id}
        - lang: JavaScript
          label: Default
          source: >
            const response = await fetch(
                "https://api.cometapi.com/replicate/v1/models/black-forest-labs/flux-schnell/predictions",
                {
                    method: "POST",
                    headers: {
                        Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
                        "Content-Type": "application/json",
                    },
                    body: JSON.stringify({
                        input: {
                            prompt: "A paper boat floating on calm water at sunrise.",
                            aspect_ratio: "1:1",
                            output_format: "webp",
                        },
                    }),
                }
            );


            const prediction = await response.json();

            console.log(prediction.id, prediction.status); // poll GET
            /replicate/v1/predictions/{id}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````