📡 Webhook API — Integration Guide

X-API-Key: YOUR_API_KEY

{
  "error": "Invalid or missing API key"
}

"reference_images": [
  "data:image/png;base64,...",
  {"data": "base64...", "category": "subject", "name": "red_car.png"}
]

GET /api/status/{task_id}    — Check task status
GET /api/result/{task_id}    — Get result
GET /api/tasks               — List tasks (max 50)
GET /api/files/{filename}    — Download binary file

import requests, time

BASE = "http://127.0.0.1:8765"
HEADERS = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

resp = requests.post(f"{BASE}/api/image/generate", headers=HEADERS, json={
    "prompt": "a futuristic city at sunset",
    "model": "nano_banana_2",
    "aspect_ratio": "16:9"
})
task_id = resp.json()["task_id"]

while True:
    s = requests.get(f"{BASE}/api/status/{task_id}", headers=HEADERS).json()
    if s["status"] == "completed":
        for url in s["results"]:
            data = requests.get(url).content   # /api/files needs no key
            open(url.split("/")[-1], "wb").write(data)
        break
    if s["status"] == "failed":
        print(s["error_code"], s["error"])
        break
    time.sleep(4)

const BASE = "http://127.0.0.1:8765";
const H = { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" };

const res = await fetch(`${BASE}/api/image/generate`, {
  method: "POST", headers: H,
  body: JSON.stringify({ prompt: "a cat in space", model: "nano_banana_2", aspect_ratio: "1:1" })
});
const { task_id } = await res.json();

const poll = setInterval(async () => {
  const s = await fetch(`${BASE}/api/status/${task_id}`, { headers: H }).then(r => r.json());
  if (s.status === "completed") { clearInterval(poll); console.log(s.results); }
  if (s.status === "failed") { clearInterval(poll); console.error(s.error); }
}, 5000);

curl http://127.0.0.1:8765/api/health

curl -X POST http://127.0.0.1:8765/api/grok/generate \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "a girl swimming", "mode": "t2i", "aspect_ratio": "16:9"}'

curl -X POST http://127.0.0.1:8765/api/meta/generate \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "a girl swimming", "mode": "t2i", "aspect_ratio": "16:9"}'

curl -H "X-API-Key: YOUR_KEY" http://127.0.0.1:8765/api/status/TASK_ID