FLUX 3 Text to Image API

curl -X POST https://api.ezflows.io/v1/models/flux-3-text-to-image \
  -H "Authorization: Bearer $EZFLOWS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Top-down flat-lay on a reclaimed-wood workbench, four components arranged in a clean grid with even daylight: a disassembled brass pocket-watch movement <watch>, a tight coil of bright copper wire <wire>, a teal printed circuit board <board>, and a fan of red-handled jeweler'\''s screwdrivers <drivers>, with a small white index card <label> in the centre. [{\"id\": \"watch\", \"bbox\": [60, 60, 470, 470], \"desc\": \"disassembled brass pocket-watch movement with exposed gears\"}, {\"id\": \"wire\", \"bbox\": [60, 530, 470, 940], \"desc\": \"tightly wound coil of bright copper wire\"}, {\"id\": \"board\", \"bbox\": [530, 60, 940, 470], \"desc\": \"teal printed circuit board with silver solder points\"}, {\"id\": \"drivers\", \"bbox\": [530, 530, 940, 940], \"desc\": \"fan of six red-handled jeweler'\''s screwdrivers\"}, {\"id\": \"label\", \"bbox\": [420, 300, 580, 700], \"desc\": \"a small white index card with the handwritten words BENCH KIT No. 3\"}]",
    "resolution": "1k",
    "aspect_ratio": "auto"
  }'

# 202 Accepted, at once — it never waits for the model:
# {"request_id": "req_8f2a41c9b70e4d15", "status": "queued",
#  "poll_url": "https://api.ezflows.io/v1/requests/req_8f2a41c9b70e4d15"}

REQUEST_ID=req_8f2a41c9b70e4d15   # from the POST

while :; do
  BODY=$(curl -s https://api.ezflows.io/v1/requests/$REQUEST_ID \
    -H "Authorization: Bearer $EZFLOWS_API_KEY")
  STATUS=$(echo "$BODY" | jq -r .data.status)
  case "$STATUS" in succeeded|failed|cancelled) break ;; esac
  sleep 3
done

echo "$BODY" | jq -r '.data.output.artifacts[].url'   # media.ezflows.io, kept 90 days

{
  "data": {
    "id": "req_8f2a41c9b70e4d15",
    "model_slug": "flux-3-text-to-image",
    "status": "succeeded",
    "http_status": 200,
    "cost": 0.05863,
    "auth_method": "api_key",
    "error": null,
    "submitted_at": "2026-09-12T18:07:21.114Z",
    "queue_started_at": "2026-09-12T18:07:21.402Z",
    "execution_started_at": "2026-09-12T18:07:22.010Z",
    "first_byte_at": "2026-09-12T18:07:52.871Z",
    "finished_at": "2026-09-12T18:07:55.203Z",
    "io_deleted_at": null,
    "canvas_id": null,
    "canvas_node_id": null,
    "client_attempt_id": null,
    "idempotency_key": null,
    "input": {
      "prompt": "Top-down flat-lay on a reclaimed-wood workbench, four components arranged in a clean grid with even daylight: a disassembled brass pocket-watch movement <watch>, a tight coil of bright copper wire <wire>, a teal printed circuit board <board>, and a fan of red-handled jeweler's screwdrivers <drivers>, with a small white index card <label> in the centre. [{\"id\": \"watch\", \"bbox\": [60, 60, 470, 470], \"desc\": \"disassembled brass pocket-watch movement with exposed gears\"}, {\"id\": \"wire\", \"bbox\": [60, 530, 470, 940], \"desc\": \"tightly wound coil of bright copper wire\"}, {\"id\": \"board\", \"bbox\": [530, 60, 940, 470], \"desc\": \"teal printed circuit board with silver solder points\"}, {\"id\": \"drivers\", \"bbox\": [530, 530, 940, 940], \"desc\": \"fan of six red-handled jeweler's screwdrivers\"}, {\"id\": \"label\", \"bbox\": [420, 300, 580, 700], \"desc\": \"a small white index card with the handwritten words BENCH KIT No. 3\"}]",
      "resolution": "1k",
      "aspect_ratio": "auto"
    },
    "output": {
      "artifacts": [
        {
          "index": 0,
          "kind": "image",
          "contentType": "image/png",
          "url": "https://media.ezflows.io/outputs/<account>/req_8f2a41c9b70e4d15/0.png"
        }
      ]
    }
  }
}

{
  "id": "82cf46a4-841e-41d6-b3c7-facc937d3252",
  "type": "request.succeeded",
  "created_at": "2026-09-12T18:07:55Z",
  "data": {
    "id": "req_8f2a41c9b70e4d15",
    "model_slug": "flux-3-text-to-image",
    "status": "succeeded",
    "cost": 0.05863,
    "output": {
      "artifacts": [
        {
          "url": "https://media.ezflows.io/…/0.png"
        }
      ]
    }
  }
}

# Create the endpoint under Webhooks in the dashboard; the signing secret is shown once.
# ezflows-signature: t=<ts>,v1=<hex HMAC-SHA256 of "<ts>.<raw body>">
# body.json = the exact bytes received. Reject anything older than five minutes.
EXPECTED=$({ printf '%s.' "$TS"; cat body.json; } \
  | openssl dgst -sha256 -hmac "$EZFLOWS_WEBHOOK_SECRET" -r | cut -d' ' -f1)

[ "$EXPECTED" = "$V1" ] && echo "valid" || echo "reject"