> ## 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. # Create a Replicate prediction > POST /replicate/v1/models/{models}/predictions creates FLUX images via Replicate format on CometAPI, with aspect ratio, quality, output format, and input tuning. 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 Submit the path model id and the `input` object through this endpoint. Save the returned `id`, because you need it for later polling. Continue with [Get a Replicate prediction](./replicate-query) until `output` is populated or an error appears. ## 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. ````