Submit Image by flux-pro

Request

Body Params application/json

input

object

required

prompt

string

required

Text prompt for image generation

aspect_ratio

string

required

Aspect ratio for the generated image
Default: "1:1"

output_format

string

required

Format of the output images.
Default: "webp"

steps

integer

required

Number of diffusion steps
Default: 25

guidance

integer

required

Controls the balance between adherence to the text prompt and image quality/diversity. Higher values make the output more closely match the prompt but may reduce overall image quality. Lower values allow for more creative freedom but might produce results less relevant to the prompt.
Default: 3

interval

integer

required

Interval is a setting that increases the variance in possible outputs letting the model be a tad more dynamic in what outputs it may produce in terms of composition, color, detail, and prompt interpretation. Setting this value low will ensure strong prompt following with more consistent outputs, setting it higher will produce more dynamic or varied outputs.
Default: 2

output_quality

integer

required

Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs
Default: 80

safety_tolerance

integer

required

Safety tolerance, 1 is most strict and 6 is most permissive
Default: 2

prompt_upsampling

boolean

required

Automatically modify the prompt for more creative generation
Default: false

seed

integer

optional

Random seed. Set for reproducible generation

Example

{
    "input": {
        "steps": 25,
        "width": 1024,
        "height": 1024,
        "prompt": "The world's largest black forest cake, the size of a building, surrounded by trees of the black forest",
        "guidance": 3,
        "interval": 2,
        "aspect_ratio": "1:1",
        "output_format": "webp",
        "output_quality": 80,
        "safety_tolerance": 2,
        "prompt_upsampling": false
    }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/replicate/v1/models/black-forest-labs/flux-pro/predictions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": {
        "steps": 25,
        "width": 1024,
        "height": 1024,
        "prompt": "The world'\''s largest black forest cake, the size of a building, surrounded by trees of the black forest",
        "guidance": 3,
        "interval": 2,
        "aspect_ratio": "1:1",
        "output_format": "webp",
        "output_quality": 80,
        "safety_tolerance": 2,
        "prompt_upsampling": false
    }
}'

Responses

🟢200OK

application/json

Body

id

string

required

model

string

required

version

string

required

input

object

required

input_image

string

required

prompt

string

required

logs

string

required

output

null

required

data_removed

boolean

required

error

null

required

status

string

required

created_at

string

required

urls

object

required

cancel

string

required

get

string

required

stream

string

required

web

string

required

message

string

required

Example

{
    "id": "k14p2hqsz1rme0cq4f8byeaz8m",
    "model": "black-forest-labs/flux-pro",
    "version": "hidden",
    "input": {
        "input_image": "https://img.upanh.tv/2025/05/30/car.jpg",
        "prompt": "Change car color to gold color"
    },
    "logs": "",
    "output": null,
    "data_removed": false,
    "error": null,
    "status": "starting",
    "created_at": "2025-05-31T00:49:47.512Z",
    "urls": {
        "cancel": "https://api.replicate.com/v1/predictions/k14p2hqsz1rme0cq4f8byeaz8m/cancel",
        "get": "https://api.replicate.com/v1/predictions/k14p2hqsz1rme0cq4f8byeaz8m",
        "stream": "https://stream.replicate.com/v1/files/bcwr-szyebczvgjjtbey5kxdtyvhljqfhjumxiigdqge2gtn7b3ahxcra",
        "web": "https://replicate.com/p/k14p2hqsz1rme0cq4f8byeaz8m"
    },
    "message": "YEScale - Replicate"
}