{"openapi":"3.1.0","info":{"title":"Grok Imagine Image 2.0 API — Cheaper Gen.","version":"1.0.0","description":"Grok Imagine Image 2.0 from xAI generates and edits striking photoreal and stylized images at 1K or 2K, with up to 3 input images for editing."},"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/xai/grok-imagine-image/text-to-image":{"post":{"summary":"Grok Imagine Image 2.0 — Text to Image","operationId":"xai_grok_imagine_image_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","3:4","4:3","9:16","16:9","2:3","3:2","1:2","2:1","9:19.5","19.5:9","9:20","20:9"],"default":"1:1"},"resolution":{"title":"Resolution","description":"1K ≈ 1 MP, 2K ≈ 4 MP.","type":"string","enum":["1K","2K"],"default":"1K"},"quality":{"title":"Quality","description":"Low is faster and cheaper; medium has more detail. (Edits always run at medium.)","type":"string","enum":["low","medium"],"default":"medium"},"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/xai/grok-imagine-image/edit":{"post":{"summary":"Grok Imagine Image 2.0 — Image Edit","operationId":"xai_grok_imagine_image_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":"1–3 images to edit or combine. Refer to them as \"image 1\", \"image 2\"… in the prompt.","type":"array","items":{"type":"string","format":"uri"},"maxItems":3},"aspect_ratio":{"title":"Aspect ratio","description":"Output image shape.","type":"string","enum":["1:1","3:4","4:3","9:16","16:9","2:3","3:2","1:2","2:1","9:19.5","19.5:9","9:20","20:9"],"default":"1:1"},"resolution":{"title":"Resolution","description":"1K ≈ 1 MP, 2K ≈ 4 MP.","type":"string","enum":["1K","2K"],"default":"1K"},"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"}}}}}}}}}