Blackforestlabs FLUX 3 Image Generate

From 12 credits/call
ae_blackforestlabs_flux_3_image_generate

FLUX 3 Klein Distilled text to image. Use when a prompt should produce a new image.

Image
From 12 credits/call

Pricing

From 12 credits/call
ConditionCharge
1K12 credits/call
1.5K24 credits/call
2K48 credits/call

Charges follow the selected settings and the rates below.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedintegerNoThe random seed to use for the generation. -1 means a random seed will be used.—
request_body.promptstringYesThe positive prompt for the generation. A full scene caption (framing, subject, background, lighting) works best.—
request_body.resolutionenum (1k | 1.5k | 2k)NoTotal output resolution tier: 1k (~1 megapixel), 1.5k (~2.4 megapixels) or 2k (~4 megapixels).1k
request_body.aspect_ratioenum (1:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | 3:2 | 3:4 | 4:3 | 4:5 | 5:4 | 9:16 | 16:9 | 9:21 | 21:9)NoThe aspect ratio of the generated image. Defaults to 1:1.1:1
request_body.output_formatenum (jpeg | png | webp)NoThe format of the output image.jpeg

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_blackforestlabs_flux_3_image_generate' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "aspect_ratio": "1:1",
      "output_format": "png",
      "prompt": "Seamless tileable texture of polished dark walnut wood, straight grain with subtle knots, satin varnish finish, top-down flat orthographic photograph, even lighting, no seams, no text, high detail wood grain",
      "resolution": "1k",
      "seed": 202622
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "80adfba2-d526-48ba-b76d-bd2eefea05ec"
}

This example shows part of the response. Copied content is valid JSON.