{"openapi":"3.0.3","info":{"title":"PhotoCen Image Generation API","version":"1.0.0","description":"Generate, personalize, and search AI images. Credits: generate=2, search=1, private +1."},"servers":[{"url":"https://api.photocen.com"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"pc_live_… (user) or pc_partner_… (partner)"}}},"security":[{"BearerAuth":[]}],"paths":{"/v1/me":{"get":{"summary":"Current account info","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/credits":{"get":{"summary":"Credit balance","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/usage":{"get":{"summary":"Usage events","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/style-memory":{"get":{"summary":"Get style memory","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}},"put":{"summary":"Update/delete style memory","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/region":{"get":{"summary":"Get region settings","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}},"put":{"summary":"Update region settings","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/images/generate":{"post":{"summary":"Generate image (idempotent, charges 2 credits, +1 if private)","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Prevents double-charging on retries."}]}},"/v1/images/jobs/{job_id}":{"get":{"summary":"Job status + result images","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/images":{"get":{"summary":"List your images","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/images/{id}":{"get":{"summary":"Image metadata + signed URL","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}},"delete":{"summary":"Delete image","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/images/search":{"post":{"summary":"Visual search (charges 1 credit)","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Prevents double-charging on retries."}]}},"/v1/tokens":{"post":{"summary":"Create API token","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}},"get":{"summary":"List tokens","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/tokens/{id}":{"delete":{"summary":"Revoke token","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/partner/users":{"post":{"summary":"Create partner user (idempotent)","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Prevents double-charging on retries."}]}},"/v1/partner/users/{external_user_id}":{"get":{"summary":"Get partner user","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}},"delete":{"summary":"Deactivate partner user","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/partner/users/{external_user_id}/images/generate":{"post":{"summary":"Generate for partner user (policy enforced)","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Prevents double-charging on retries."}]}},"/v1/partner/users/{external_user_id}/images":{"get":{"summary":"List partner user images","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/partner/images/search":{"post":{"summary":"Partner visual search","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Prevents double-charging on retries."}]}},"/v1/partner/usage":{"get":{"summary":"Partner usage","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v1/partner/credits":{"get":{"summary":"Partner credit balance","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/{width}/{height}":{"get":{"summary":"Random catalog image at WxH (single edge => square). Charges 1 credit. Query: grayscale, blur=1..10; .jpg/.webp/.png suffix selects format.","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/id/{id}/{width}/{height}":{"get":{"summary":"A specific catalog image at WxH. Charges 1 credit.","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/seed/{seed}/{width}/{height}":{"get":{"summary":"Deterministic image for a seed at WxH. Charges 1 credit.","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/id/{id}/info":{"get":{"summary":"Catalog image metadata (id, author, width, height, url, download_url). Free.","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}},"/v2/list":{"get":{"summary":"Paginated catalog (page, limit; Link + X-Total-Count headers). Free.","responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"}}}}}}