danielkrause/BSN-Chatsystem

Fork 0

Files

T

Hermes Agent 31687f7e44

Quality Gate / 🛡️ Lint + Type Check + Tests (push) Failing after 11m32s

Details

docs: NanoBanana Skill — 1920×1080 @ 72 DPI Standard + Post-Processing

2026-06-22 22:24:07 +02:00

6.8 KiB

Raw Blame History

name, description, version, category, metadata

name

description

version

NanoBanana Image Generation — BSN News

API: https://api.nanobananaapi.ai Docs: https://docs.nanobananaapi.ai Auth: Authorization: Bearer <API_KEY> (in ~/.hermes/profiles/cody/.env als NANOBANANA_API_KEY) Modelle: NanoBanana AI (Basis), NanoBanana 2 (empfohlen), NanoBanana Pro

API-Referenz

POST /api/v1/nanobanana/generate-2 (empfohlen)

{
  "prompt": "Text-Prompt (max 20.000 Zeichen)",
  "imageUrls": ["https://...brettspiel-cover.jpg"],  // [] für Text-to-Image
  "aspectRatio": "16:9",   // 1:1|1:4|2:3|3:2|3:4|4:3|4:5|5:4|9:16|16:9|21:9|auto
  "resolution": "2K",      // 1K|2K|4K
  "googleSearch": false,   // Web-Grounding für Akkuratesse
  "outputFormat": "jpg",   // png|jpg
  "callBackUrl": ""        // Optional, für async
}

Response: {"code": 200, "msg": "success", "data": {"taskId": "abc123"}}

GET /api/v1/nanobanana/record-info?taskId=abc123

Response (fertig):

{
  "code": 200,
  "data": {
    "status": "SUCCESS",
    "imageUrls": ["https://cdn.nanobananaapi.ai/result/abc123_0.jpg"],
    "prompt": "...",
    "taskId": "abc123"
  }
}

Status-Werte: PENDING → warten, SUCCESS → fertig, FAILED → Fehler

POST /api/v1/nanobanana/generate (Basis-Modell)

{
  "prompt": "...",
  "type": "TEXTTOIAMGE",   // TEXTTOIAMGE|IMAGETOIAMGE
  "numImages": 1,          // 1-4
  "imageUrls": [],
  "callBackUrl": ""
}

BSN-Use-Cases

⚡ Standard-Format für ALLE BSN-Bilder

Parameter	Wert
Auflösung	1920 × 1080 px
DPI	72 (Web-Standard)
Format	JPG
API-Mapping	`resolution: "2K"` + `aspectRatio: "16:9"`

Wichtig: Die API garantiert keine exakten Pixelmaße. Mit 2K + 16:9 kommt ca. 1920×1080 heraus. Bei Abweichungen → Post-Processing mit Pillow (s.u.).

1. Artikel-Header-Bild aus Prompt

curl -s -X POST "https://api.nanobananaapi.ai/api/v1/nanobanana/generate-2" \
  -H "Authorization: Bearer *** get bsn/nanobanana-key)" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Professional board game photography of Catan, hexagonal tiles, wooden pieces, warm lighting, 4K product shot style",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "imageUrls": [],
    "outputFormat": "jpg"
  }'

2. Brettspiel-Cover veredeln (Image-to-Image)

curl -s -X POST "https://api.nanobananaapi.ai/api/v1/nanobanana/generate-2" \
  -H "Authorization: Bearer *** get bsn/nanobanana-key)" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Transform this board game cover into a cinematic movie poster style, dramatic lighting, epic composition, keep the game title and theme",
    "imageUrls": ["https://example.com/catan-cover.jpg"],
    "aspectRatio": "16:9",
    "resolution": "2K",
    "outputFormat": "jpg"
  }'

3. Post-Processing: Exakt 1920×1080 + 72 DPI

from PIL import Image

def normalize_bsn_image(path: str) -> str:
    """Bringt Bild auf exakt 1920×1080, 72 DPI, JPG."""
    img = Image.open(path)
    img = img.convert("RGB")  # Falls PNG/RGBA
    img = img.resize((1920, 1080), Image.LANCZOS)
    img.save(path, "JPEG", quality=92, dpi=(72, 72))
    return path

4. Polling bis zum Ergebnis (Python)

import time, requests, json

API_KEY = subprocess.run(["bsn-secrets","get","bsn/nanobanana-key"], capture_output=True, text=True).stdout.strip()
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Task starten
resp = requests.post("https://api.nanobananaapi.ai/api/v1/nanobanana/generate-2", headers=HEADERS, json={
    "prompt": prompt,
    "imageUrls": image_urls if image_urls else [],
    "aspectRatio": aspect_ratio,
    "resolution": resolution,
    "outputFormat": output_format,
}).json()

task_id = resp["data"]["taskId"]

# Pollen
for _ in range(30):  # max 5 Minuten
    time.sleep(10)
    r = requests.get(f"https://api.nanobananaapi.ai/api/v1/nanobanana/record-info?taskId={task_id}", headers=HEADERS).json()
    if r["data"]["status"] == "SUCCESS":
        return r["data"]["imageUrls"]
    elif r["data"]["status"] == "FAILED":
        raise Exception("Generation failed")

raise TimeoutError("Timeout after 5 minutes")

Prompt-Engineering für Brettspiele

Gute Prompts (funktionieren):

"Professional product photography of [SPIELNAME] board game, box art, cinematic lighting, 4K resolution, clean background"
"A family playing [SPIELNAME] at a wooden table, warm candlelight, cozy atmosphere, lifestyle photography"
"Transform this board game cover into a [STIL] style poster, keep title and key art elements"

Aspect-Ratio-Guide:

Zweck	Ratio	Entspricht
Header-Bild (News) ⭐	16:9	1920×1080 px
Thumbnail	1:1	Quadratisch
Instagram/Story	9:16	Hochformat
Cover-Reproduktion	2:3	Standard-Brettspiel-Box
Breitformat-Banner	21:9	Ultrawide

Styles für Brettspiel-Bilder:

product shot style — clean, wie Amazon-Produktbilder
lifestyle photography — Menschen spielen am Tisch
cinematic movie poster — dramatisch, episch
flat lay top-down — von oben, alle Komponenten sichtbar
watercolor illustration — künstlerisch, handgemalt

API-Key-Management

Der API-Key wird als Secret via bsn-secrets gespeichert:

echo "nb_api_key..." | bsn-secrets set bsn/nanobanana-key

Abruf: bsn-secrets get bsn/nanobanana-key

Key beziehen: https://nanobananaapi.ai/api-key

Kosten

Credit-basiertes System — vor Nutzung Credits prüfen:

curl -s "https://api.nanobananaapi.ai/api/v1/common/account-credits" \
  -H "Authorization: Bearer $(bsn-secrets get bsn/nanobanana-key)"

Pitfalls

Task ist asynchron — POST gibt sofort taskId zurück, Ergebnis erst nach 10-60s via GET
NICHT blockierend warten — Pollen mit 10s Intervallen, max 30 Versuche
imageUrls: [] für Text-to-Image — Leeres Array, nicht weglassen
Prompt-Länge max 20K bei generate-2, weniger bei generate
Aspect-Ratio als String "16:9" — nicht als Float
Status-Check: Immer r["data"]["status"] prüfen — nicht r["code"]
Keine exakten Pixel-Garantien — API liefert ~1920×1080 bei 2K+16:9. Immer mit normalize_bsn_image() nachbearbeiten für exakte 1920×1080 @ 72 DPI
DPI wird von API nicht gesetzt — JPGs aus der API haben oft keine DPI-Metadaten. PIL.Image.save(dpi=(72,72)) behebt das

6.8 KiB Raw Blame History Unescape Escape