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

# FLUX Create Task Replicate

> Use DeerAPI to call the FLUX Create Task Replicate endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the FLUX Create Task Replicate workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/image/flux/post-create-task-replicate.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 DeerAPI and receive a prediction id
    for later polling.
servers:
  - url: https://api.deerapi.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
            example:
              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: cURL
          source: >
            curl
            https://api.deerapi.com/replicate/v1/models/models-value/predictions
            \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "input": {
                  "prompt": "A paper boat floating on calm water at sunrise.",
                  "aspect_ratio": "1:1",
                  "output_format": "webp",
                  "output_quality": 80
                }
              }'
        - lang: Python
          label: requests
          source: >
            import os

            import requests


            url =
            "https://api.deerapi.com/replicate/v1/models/models-value/predictions"

            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }

            payload = {
              "input": {
                "prompt": "A paper boat floating on calm water at sunrise.",
                "aspect_ratio": "1:1",
                "output_format": "webp",
                "output_quality": 80
              }
            }


            response = requests.post(url, headers=headers, json=payload)

            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/replicate/v1/models/models-value/predictions",
            {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_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",
                  "output_quality": 80
                }
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````