> ## 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.

# إنشاء prediction في Replicate

> يقوم POST /replicate/v1/models/{models}/predictions بإنشاء صور FLUX عبر تنسيق Replicate على CometAPI، مع نسبة الأبعاد، والجودة، وتنسيق الإخراج، وضبط input.

استخدم هذا المسار لبدء prediction بأسلوب Replicate على CometAPI واسترجاع prediction id لاستخدامه لاحقًا في polling.

## قائمة التحقق للطلب الأول

* ضع كل معلمات model داخل الكائن `input`
* ابدأ بـ `black-forest-labs/flux-schnell` للحصول على أسرع طلب أول
* اجعل الطلب الأول نصيًا فقط ما لم تكن تحتاج تحديدًا إلى `input_image` أو `input_images`
* احفظ قيمة `id` المُعادة للتحقق من الحالة

## تدفق المهمة

<Steps>
  <Step title="إنشاء prediction">
    أرسل model ID الخاص بالمسار والكائن `input` عبر نقطة النهاية هذه.
  </Step>

  <Step title="تخزين prediction id">
    احفظ `id` المُعاد، لأنك ستحتاج إليه في polling لاحقًا.
  </Step>

  <Step title="إجراء polling على prediction">
    تابع إلى [الحصول على prediction في Replicate](./replicate-query) حتى تتم تعبئة `output` أو يظهر خطأ.
  </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.

````