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** ⚠️