Imgen Cache API

curl -X POST https://imgen-cache.demo.efficientstack.com//api/search \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"query":"sunset over mountains","limit":5}'

Authorization: Bearer YOUR_API_KEY

https://imgen-cache.demo.efficientstack.com/api

{
    "query": "cinematic portrait at golden hour",
    "character": "aya",
    "search_in": "both",
    "limit": 5
  }

{
    "results": [
      {
        "id": "a1b2c3d4",
        "url": "https://cdn.example.com/images/a1b2c3d4.png",
        "thumbnail": "https://cdn.example.com/thumbs/a1b2c3d4.jpg",
        "width": 1024,
        "height": 1536,
        "character": "aya",
        "model": "sdxl",
        "style": "photoreal",
        "prompt": "portrait, shallow depth of field, warm sunset light",
        "caption": "A close-up portrait in warm golden-hour light with a soft blurred background.",
        "score": 0.842
      }
    ],
    "count": 1
  }

{
    "prompt": "a quiet lakeside at dawn, soft mist",
    "style": "photoreal"
  }

{
    "image": {
      "id": "a1b2c3d4",
      "url": "https://cdn.example.com/images/a1b2c3d4.png",
      "thumbnail": "https://cdn.example.com/thumbs/a1b2c3d4.jpg",
      "width": 1024,
      "height": 1536,
      "character": "",
      "model": "sdxl",
      "style": "photoreal",
      "prompt": "misty lake, golden dawn light, reflections on still water",
      "caption": "A misty lake at dawn with pale golden light and still, reflective water."
    }
  }

{
    "characters": ["aya", "mira", "noa"]
  }

{
    "models": ["sdxl", "flux"]
  }

{
    "styles": ["photoreal", "illustration", "cinematic"]
  }

{
    "error": "human-readable description of what went wrong"
  }

curl -X POST https://imgen-cache.demo.efficientstack.com/api/search \
    -H "Authorization: Bearer $IMGEN_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "query": "soft pastel illustration of a garden",
      "style": "illustration",
      "limit": 8
    }'

const BASE = 'https://imgen-cache.demo.efficientstack.com';
  const KEY  = process.env.IMGEN_API_KEY;
  
  async function search(query, opts) {
    opts = opts || {};
    const res = await fetch(BASE + '/api/search', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer ' + KEY,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        query: query,
        character: opts.character,
        model: opts.model,
        style: opts.style,
        search_in: opts.search_in || 'both',
        limit: opts.limit || 10,
      }),
    });
  
    if (!res.ok) {
      const err = await res.json().catch(function () { return { error: res.statusText }; });
      throw new Error('Search failed (' + res.status + '): ' + err.error);
    }
  
    const data = await res.json();
    return data.results;
  }
  
  // Usage
  const results = await search('sunset over mountains', { limit: 5 });
  for (const img of results) {
    console.log(img.id, img.score.toFixed(3), img.url);
  }

import os
  import requests
  
  BASE = "https://imgen-cache.demo.efficientstack.com"
  KEY  = os.environ["IMGEN_API_KEY"]
  
  def search(query, **opts):
      r = requests.post(
          f"{BASE}/api/search",
          headers={
              "Authorization": f"Bearer {KEY}",
              "Content-Type": "application/json",
          },
          json={
              "query": query,
              "character": opts.get("character"),
              "model":     opts.get("model"),
              "style":     opts.get("style"),
              "search_in": opts.get("search_in", "both"),
              "limit":     opts.get("limit", 10),
          },
          timeout=15,
      )
      r.raise_for_status()
      return r.json()["results"]
  
  # Usage
  for img in search("sunset over mountains", limit=5):
      print(img["id"], round(img["score"], 3), img["url"])