SDKs, libraries and tools

from popnow import PopNow

client = PopNow()  # reads POPNOW_API_KEY

task = client.images.generate(
    model="google/nano-banana-2.1/text-to-image",
    prompt="A small red fox curled up in a teacup, soft morning light",
)
print(task.state, task.urls[0])
client.files.download(task.assets[0], "fox.png")

import { PopNow } from "popnow";

const popnow = new PopNow(); // reads POPNOW_API_KEY

const task = await popnow.jobs.createAndWait({
  model: "google/nano-banana-2.1/text-to-image",
  input: { prompt: "A small red fox curled up in a teacup, soft morning light" },
});
console.log(task.state, task.output?.assets?.[0]?.url);

package main

import (
	"context"
	"log"

	popnow "github.com/popnow-ai/popnow-go"
)

func main() {
	ctx := context.Background()
	client, err := popnow.New(popnow.Options{}) // reads POPNOW_API_KEY
	if err != nil {
		log.Fatal(err)
	}

	request := popnow.CreateTaskInput{
		Model: "google/nano-banana-2.1/text-to-image",
		Input: map[string]any{"prompt": "A small red fox curled up in a teacup, soft morning light"},
	}
	// One idempotency key per piece of work: a resend returns the original task.
	task, err := client.CreateTask(ctx, request, "fox-teacup-1", popnow.CreateTaskOptions{})
	if err != nil {
		log.Fatal(err)
	}
	final, err := client.WaitForTerminal(ctx, task.TaskID, popnow.WaitOptions{})
	if err != nil {
		log.Fatal(err)
	}
	for _, asset := range final.ReadyAssets() {
		log.Println(final.State, asset.URL)
	}
}

<?php
require __DIR__ . '/vendor/autoload.php';

use PopNow\Client;

$client = new Client(); // reads POPNOW_API_KEY

$task = $client->createTask(
    model: 'google/nano-banana-2.1/text-to-image',
    input: ['prompt' => 'A small red fox curled up in a teacup, soft morning light'],
    idempotencyKey: Client::idempotencyKey(),
    waitSeconds: 60,
);
if (!Client::isTerminal($task)) {
    $task = $client->waitForTerminal($task['taskId']);
}
foreach (Client::readyAssets($task) as $asset) {
    echo $asset['url'], "\n";
}

import ai.popnow.*;
import java.util.Map;
import java.util.UUID;

public class Quickstart {
    public static void main(String[] args) {
        PopNowClient client = PopNowClient.builder().apiKeyFromEnvironment().build(); // POPNOW_API_KEY

        CreateTaskRequest request = CreateTaskRequest.of("google/nano-banana-2.1/text-to-image",
                Map.of("prompt", "A small red fox curled up in a teacup, soft morning light"));

        // createTask + waitForTerminal; the key makes a resend return the original task
        TaskRecord task = client.run(request, UUID.randomUUID().toString());

        System.out.println(task.state());
        for (TaskAsset asset : task.assets()) {
            asset.url().ifPresent(System.out::println);
        }
    }
}

popnow jobs create \
  --model google/nano-banana-2.1/text-to-image \
  --input-json '{"prompt":"A small red fox curled up in a teacup, soft morning light"}' \
  --wait

curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "google/nano-banana-2.1/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "output_format": "png"
  }
}'