AiImages - BevvyTech/BrewskiDocs GitHub Wiki

AI Images

Method Path Description
GET /ai/images Paginated gallery of AI generated beer badges for a team.

GET /ai/images

  • Auth: Bearer token. Caller must belong to the requested team.
  • Query Parameters:
    • teamId (uuid, required) – team whose generated images will be returned.
    • page (integer, default 1) – page number (1-indexed).
    • pageSize (integer, default 12, max 50) – results per page.
  • Response 200: 
    {
  "teamId": "d43c046a-10a1-4f52-bd0a-9bf16f828ab7",
  "page": 1,
  "pageSize": 12,
  "total": 32,
  "pages": 3,
  "results": [
    {
      "id": "15b15f55-98ed-4d8b-8a04-17a6ca2c3c5c",
      "teamId": "d43c046a-10a1-4f52-bd0a-9bf16f828ab7",
      "beer": { "id": "8f62...", "name": "Lantern Pale" },
      "createdBy": { "id": "b97d...", "name": "Brew Master", "email": "[email protected]" },
      "prompt": "I need an image of a circular beer badge...",
      "revisedPrompt": "Circular beer badge with citrus accents...",
      "style": "Circular using beer data",
      "styleHints": "Flat vector, gold outlines",
      "size": "1024x1024",
      "model": "gpt-image-1",
      "provider": "openai",
      "imageUrl": "https://cdn.brewskiapp.com/teams/.../generated-1712054832.png",
      "storageKey": "beer-8f62/generated-1712054832.png",
      "createdAt": "2025-04-30T10:15:07.000Z",
      "usage": {
        "id": "d4c8b999-7db7-46e6-9f9d-d1045f879f93",
        "inputTokensText": 120,
        "inputTokensImage": 800,
        "outputTokensImage": 1024,
        "totalTokens": 1944,
        "createdAt": "2025-04-30T10:15:07.000Z"
      }
    }
  ]
}
    • usage reflects the token ledger entry in ai_image_usage tied to the generated asset (values may be null when the provider omits that bucket).
  • Errors: 401 unauthorized, 403 forbidden (user not on requested team).
⚠️ **GitHub.com Fallback** ⚠️