• Java 11+
• org.json:json

Maven snippet:

<dependency>
  <groupId>org.json</groupId>
  <artifactId>json</artifactId>
  <version>20230227</version>
</dependency>

Usage Examples 🚀

Initialize

Kontext4J k = new Kontext4J().init("YOUR_API_KEY_HERE"); 
// no api key? no magic. 💀

Generate (text → image)

k.model("generate")
 .generate(
     "A tiny robot sipping coffee, cinematic lighting, ultra detailed",
     null, "16:9", 42, 30, 7.5, null, null,
     "png", null, null, 1, null, null, null
 );
System.out.println("Image URL: " + k.getUrl());
// other libs would still be configuring XML, we already sipping coffee. ☕🤖

Simple Generate

k.generateSimple("Cyberpunk cat in neon alley");
System.out.println(k.getUrl());
// because we don't need 300 MB of JARs for one cat. 🐱💡

Edit with multiple images

k.edit(
    "/home/me/pic1.jpg",
    "/home/me/pic2.jpg",
    null, null,
    "Make all subjects wear futuristic helmets",
    null, "1:1", 12345, 40, 6.0,
    null, null, "jpg",
    null, null, 2
);
System.out.println(k.getUrls());
// other libs: "please configure 12 XML files." 🤡

Simple Edit

k.editSimple("/home/me/selfie.jpg", "Add sunglasses and party lights");
System.out.println(k.getUrl());

Merge multiple images

k.editMerge(List.of("/pic1.jpg","/pic2.jpg"), "Turn them into a superhero squad");
System.out.println(k.getUrls());

Fill / Inpaint

k.fill(
    "/home/me/photo.jpg",
    "/home/me/mask.png",
    "replace",
    "Make subject wear a futuristic helmet",
    null, "1:1", 12345, 40, 6.0, null, null,
    "jpg", null, null, 1
);
System.out.println(k.getUrls());
// inpainting so smooth, other libs cry into their 17 threads. 😭

Expand / Outpaint

k.expand(
    "https://example.com/input.png",
    200, 0, 0, 200,
    "Extend environment to neon city skyline",
    null, 40, 7.0, null, null, "png", null, null, 1
);
System.out.println(k.getUrl());
// other libs: "Wait… which edge is left again?" 🤔

Download last result

k.download(Paths.get("kontext_result.png"));
// no fuss, no spaghetti code. 🍝

Download a particular result index

k.downloadIndex(Paths.get("kontext_result2.png"), 0);

All Public Methods 🛠

• init(String apiKey)
• model(String modelName) — "edit" | "fill" | "generate" | "expand"
• setRequestTimeout(Duration d)
• setPollIntervalMillis(long ms)
• setMaxWaitMillis(long ms)
• edit(...), editSimple(...), editMerge(...)
• fill(...)
• generate(...), generateSimple(...)
• expand(...)
• getUrls(), getUrl(), getLastRawResult()
• download(Path), downloadIndex(Path, int)

Nano Banana 🍌

Sometimes, very rarely, a URL or sample might contain a nano banana. No promises. Full giggle guaranteed when it shows up.

Troubleshooting 🛑

• No result available — forgot init(apiKey)?
• Polling timed out — increase setMaxWaitMillis(...) or check webhook.
• Invalid JSON — server sent a JSON-shaped potato 🥔.

License 📝

MIT recommended. Free, petty, and small — like your nano banana.

Contact / Socials 📱

📱 Connect with Me

(Memes > bug reports)

Final Words 🏁

Kontext4J is tiny but opinionated: minimal dependencies, sane defaults, speed > drama. Use it to edit, generate, fill, expand — maybe find a nano banana too. 🍌