{"openapi":"3.1.0","info":{"title":"FLUX.2 [klein] 4B API — Cheaper Gen.","version":"1.0.0","description":"FLUX.2 [klein] 4B is Black Forest Labs' small, open (Apache-2.0) FLUX.2 model: sub-second text-to-image and editing with up to 4 reference images, at a fraction of a cent per image."},"servers":[{"url":"https://cheapergen.com/api/v1"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Generation":{"type":"object","properties":{"id":{"type":"string"},"object":{"const":"generation"},"model":{"type":"string"},"endpoint":{"type":"string"},"status":{"enum":["queued","running","succeeded","failed","canceled"]},"output":{"type":["object","null"]},"error":{"type":["object","null"]},"cost":{"type":"object","properties":{"amount_usd":{"type":"number"},"official_usd":{"type":["number","null"]},"saved_usd":{"type":["number","null"]},"estimated":{"type":"boolean"}}},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":["string","null"],"format":"date-time"}}}}},"paths":{"/run/bfl/flux-2-klein-4b/text-to-image":{"post":{"summary":"FLUX.2 [klein] 4B — Text to Image","operationId":"bfl_flux_2_klein_4b_text_to_image","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"title":"Prompt","description":"Describe the shot: subject, action, camera movement, lighting and style.","type":"string","maxLength":5000},"aspect_ratio":{"title":"Aspect ratio","description":"Output image shape.","type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"resolution":{"title":"Resolution","description":"1K ≈ 1 MP; 2K ≈ 4 MP (long side up to 2048 px).","type":"string","enum":["1K","2K"],"default":"1K"},"seed":{"title":"Seed","description":"Use the same seed and settings to reproduce a result. Leave empty for random.","type":"integer","minimum":0,"maximum":2147483647},"webhook_url":{"type":"string","format":"uri","title":"Webhook URL","description":"Optional. We POST the finished generation here (signed)."}},"additionalProperties":false}}}},"responses":{"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient balance"}}}},"/run/bfl/flux-2-klein-4b/edit":{"post":{"summary":"FLUX.2 [klein] 4B — Image Edit","operationId":"bfl_flux_2_klein_4b_edit","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt","image_urls"],"properties":{"prompt":{"title":"Prompt","description":"Describe the shot: subject, action, camera movement, lighting and style.","type":"string","maxLength":5000},"image_urls":{"title":"Input images","description":"Up to 4 reference images to edit or combine. Refer to them as \"image 1\", \"image 2\"… in the prompt.","type":"array","items":{"type":"string","format":"uri"},"maxItems":4},"aspect_ratio":{"title":"Aspect ratio","description":"Output image shape.","type":"string","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"],"default":"1:1"},"resolution":{"title":"Resolution","description":"1K ≈ 1 MP; 2K ≈ 4 MP (long side up to 2048 px).","type":"string","enum":["1K","2K"],"default":"1K"},"seed":{"title":"Seed","description":"Use the same seed and settings to reproduce a result. Leave empty for random.","type":"integer","minimum":0,"maximum":2147483647},"webhook_url":{"type":"string","format":"uri","title":"Webhook URL","description":"Optional. We POST the finished generation here (signed)."}},"additionalProperties":false}}}},"responses":{"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"400":{"description":"Invalid request"},"402":{"description":"Insufficient balance"}}}},"/generations/{id}":{"get":{"summary":"Get a generation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}}}}}}}