Imgen Cache API

curl -X POST https://example.com/api/search \
  -H "Authorization: Bearer $IMGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sunset over mountains","limit":5}'

Authorization: Bearer YOUR_API_KEY

https://example.com/api

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

{
  "results": [
    {
      "id": "a1b2c3d4",
      "gen_id": "g-8817",
      "url": "https://cdn.example.com/08-26/2450c4bc/5c5be245.jpg",
      "thumbnail": "https://cdn.example.com/08-26/2450c4bc/5c5be245_t.jpg",
      "width": 832,
      "height": 1216,
      "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,
      "top": true
    }
  ],
  "count": 1
}

{
  "image": {
    "id": "a1b2c3d4",
    "url": "https://cdn.example.com/08-26/2450c4bc/5c5be245.jpg",
    "thumbnail": "https://cdn.example.com/08-26/2450c4bc/5c5be245_t.jpg",
    "width": 832,
    "height": 1216,
    "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" }

const BASE = 'https://example.com';
const KEY = process.env.IMGEN_API_KEY;

async function search(query, opts = {}) {
  const res = await fetch(BASE + '/api/search', {
    method: 'POST',
    headers: {
      Authorization: 'Bearer ' + KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      query,
      character: opts.character,
      model: opts.model,
      style: opts.style,
      search_in: opts.searchIn || 'both',
      limit: opts.limit || 10,
    }),
    signal: AbortSignal.timeout(15000),
  });

  if (res.status === 429) {
    throw new Error('rate limited; retry after ' + res.headers.get('Retry-After') + 's');
  }
  if (!res.ok) {
    const err = await res.json().catch(() => ({ error: res.statusText }));
    throw new Error('search failed (' + res.status + '): ' + err.error);
  }

  const { results } = await res.json();
  return results;
}

for (const img of await search('sunset over mountains', { limit: 5 })) {
  console.log(img.id, img.score.toFixed(3), img.thumbnail);
}

import os
import requests

BASE = "https://example.com"
KEY = os.environ["IMGEN_API_KEY"]

session = requests.Session()
session.headers.update({
    "Authorization": f"Bearer {KEY}",
    "Content-Type": "application/json",
})

def search(query, **opts):
    r = session.post(
        f"{BASE}/api/search",
        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"]

for img in search("sunset over mountains", limit=5):
    print(img["id"], round(img["score"], 3), img["thumbnail"])