{"openapi":"3.1.0","info":{"title":"Brandiseer Developer API","version":"1.0.0","description":"Brandiseer's developer API for programmatic, brand-consistent image generation. Authenticate with the X-API-Key header.","contact":{"name":"Brandiseer","url":"https://brandiseer.com/developers/docs"}},"servers":[{"url":"https://brandiseer.com/api/v1","description":"Production"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"auth_token"}}},"paths":{"/health":{"get":{"summary":"Health check","description":"Returns ok if the API is reachable.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","const":"ok"}},"required":["status"]}}}}}}},"/keys":{"get":{"summary":"List API keys","description":"List active API keys for the authenticated user (cookie session).","security":[{"CookieAuth":[]}],"responses":{"200":{"description":"List of API keys"},"401":{"description":"Unauthorized"}}}},"/credits":{"get":{"summary":"Get current credits balance","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Credits balance"},"401":{"description":"Unauthorized"}}}},"/usage":{"get":{"summary":"Get API usage summary","security":[{"CookieAuth":[]}],"responses":{"200":{"description":"Usage summary"},"401":{"description":"Unauthorized"}}}},"/my-brands":{"get":{"summary":"List my custom brands (cookie session)","security":[{"CookieAuth":[]}],"responses":{"200":{"description":"Brands list"},"401":{"description":"Unauthorized"}}}},"/brands":{"get":{"summary":"List custom brands (API key)","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Brands list"},"401":{"description":"Unauthorized"}}}},"/generate":{"post":{"summary":"Generate a brand-consistent image","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["brandId","prompt"],"properties":{"brandId":{"type":"string","description":"Brand id, e.g. bds_c_123"},"prompt":{"type":"string"},"aspectRatio":{"type":"string","enum":["1:1","16:9","9:16","4:3"],"default":"1:1"},"resolution":{"type":"string","enum":["1K","2K","4K"],"default":"1K"},"proMode":{"type":"boolean","default":false},"useLogo":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Generated image url and credits used"},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"},"404":{"description":"Brand not found"},"500":{"description":"Generation failed"}}}}}}