Skip to main content
POST
/
flux
/
v1
/
{model}
cURL
curl https://api.deerapi.com/flux/v1/gemini-2.5-flash \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "prompt": "A paper boat floating on calm water at sunrise."
  }'
{
  "id": "<string>",
  "polling_url": "<string>"
}

​
Overview

Use this endpoint to call the FLUX Generate 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: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. 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.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

Headers

​
Content-Type
string

Must be application/json.

Path Parameters

​
model
string
required

Flux model variant to use, e.g. flux-pro-1.1, flux-pro, flux-dev, flux-pro-1.1-ultra.

Body

application/json
​
prompt
string
default:Hello
required

Text prompt describing the image to generate.

​
image_prompt
string

URL of a reference image to guide the generation style or content.

​
width
integer

Output image width in pixels. Must be a multiple of 32. Range varies by model.

​
height
integer

Output image height in pixels. Must be a multiple of 32. Range varies by model.

​
steps
integer

Number of diffusion steps. Higher values improve quality but increase latency.

​
prompt_upsampling
boolean

When true, automatically enhances the prompt for more detailed results.

​
seed
integer

Random seed for reproducible outputs. Omit for random generation.

​
guidance
number

Guidance scale controlling how closely the output follows the prompt. Higher values increase prompt adherence.

​
safety_tolerance
integer

Safety filter tolerance level. Higher values are more permissive. Range: 0–6.

​
interval
integer

Diversity interval. Higher values produce more varied outputs at the cost of prompt adherence.

​
output_format
string

Output image format. Supported values: jpeg, png.

​
webhook_url
string

URL to receive a POST notification when the task completes.

​
webhook_secret
string

Secret string included in webhook payloads for request verification.

Response

200 - application/json

OK

​
id
string
​
polling_url
string