New: Nano Banana 2.1Try the model
API Stock

API Stock vs PiAPI

PiAPI alternative

Compare PiAPI with API Stock for image generation, prepaid billing and task delivery. The table covers Nano Banana and two Nano Banana Pro resolution tiers.

How API Stock compares with PiAPI

When to choose API Stock

Choose API Stock for supported PiAPI image models when you want Bearer authentication and a flat request body instead of separate model and task_type selectors.

When to keep PiAPI

PiAPI has task types and account-hosting workflows that do not have a direct equivalent here. Migrate supported models individually; a matching model name does not guarantee every task type is available.

PiAPI API documentation

Scroll horizontally to read all table columns.

API changes: PiAPI to API Stock
Integration detailPiAPIAPI Stock
RequestPOST /api/v1/taskPOST /api/v1/generation/create
AuthenticationX-API-KeyAuthorization: Bearer
Model identifiermodel: gemini / task_type: gemini-2.5-flash-imagenano-banana

This compares the example model below, not every endpoint the provider offers. Shared model names do not guarantee identical parameters, moderation or output.

Price comparison: PiAPI and API Stock

Selected shared models with matching billing units. Our prices come from the current catalog; competitor prices are dated observations linked to their sources.

Price comparison: PiAPI and API Stock
Nano Bananaper image · text to imageAPI Stock$0.015PiAPI$0.0350% lower
Nano Banana Pro1K · per image · text to imageAPI Stock$0.04PiAPI$0.10561.9% lower
Nano Banana Pro4K · per image · text to imageAPI Stock$0.05PiAPI$0.1872.2% lower

One image from a text prompt, without reference images. These are public base rates; plans, volume discounts, other resolutions and editing can change the final price.

What a workload costs

Nano Banana

1,000 images, the configuration above

API Stock
$15
PiAPI
$30

Nano Banana Pro · 1K

1,000 images, the configuration above

API Stock
$40
PiAPI
$105

Illustrative totals from the rows above, without volume discounts, subscriptions or additional paid options. These examples do not predict latency or identical outputs.

Pricing

Migrating from PiAPI

Replace X-API-Key with Authorization: Bearer and move model, task_type and input to the public model id and documented top-level parameters. Change task_id handling to taskId and adapt the status and webhook response parser.

  1. 1

    Create an account, top up your prepaid balance and issue an API key.

  2. 2

    POST to /api/v1/generation/create with the public model id and its documented parameters. Each task generates one output.

  3. 3

    Read taskId from the response. Poll GET /api/v1/task/status/TASK_ID, or set webhook in the creation request.

PiAPI

bash
curl --fail-with-body 'https://api.piapi.ai/api/v1/task' \
-H "X-API-Key: $PIAPI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini",
"task_type": "gemini-2.5-flash-image",
"input": {
"prompt": "A ceramic mug on a wooden table, soft morning light",
"aspect_ratio": "1:1"
}
}'

API Stock

bash
curl --fail-with-body 'https://api.api-stock.com/api/v1/generation/create' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "nano-banana",
"prompt": "A ceramic mug on a wooden table, soft morning light"
}'
Complete example: create a task and download its result

Run on your server with Node 22+ or Bun and API_KEY set. This example creates one paid task, then polls without creating it again. Finished URLs are temporary: save the file to your own storage.

javascript
import { writeFile } from "node:fs/promises";
const baseURL = "https://api.api-stock.com/api/v1";
const apiKey = process.env.API_KEY;
if (!apiKey) throw new Error("Set API_KEY on the server");
async function request(path, options = {}) {
const response = await fetch(baseURL + path, {
...options,
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(await response.text());
return response.json();
}
const { taskId } = await request("/generation/create", {
method: "POST",
body: JSON.stringify({
"model": "nano-banana",
"prompt": "A ceramic mug on a wooden table, soft morning light"
}),
});
if (!taskId) throw new Error("Missing taskId");
const deadline = Date.now() + 10 * 60_000;
let fileUrl;
while (Date.now() < deadline) {
const { data } = await request(`/task/status/${encodeURIComponent(taskId)}`);
if (data.status === "finished") {
fileUrl = data.files?.[0]?.fileUrl;
if (!fileUrl) throw new Error("Task finished without a file");
break;
}
if (data.status === "failed" || data.status === "expired") {
throw new Error(data.errorMessage || data.status);
}
await new Promise((resolve) => setTimeout(resolve, 2000));
}
if (!fileUrl) throw new Error(`Still processing: save taskId ${taskId} and resume polling`);
const file = await fetch(fileUrl, { signal: AbortSignal.timeout(60_000) });
if (!file.ok) throw new Error(`Download failed: ${file.status}`);
const mime = file.headers.get("content-type")?.split(";")[0];
const extension = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" }[mime] || "bin";
await writeFile(`generated-image.${extension}`, new Uint8Array(await file.arrayBuffer()));

Keep API keys on your server. When migrating, test one request and compare its parameters, status handling and output before moving production traffic.

Frequently asked questions

How do I migrate from PiAPI?

Replace X-API-Key with Authorization: Bearer and move model, task_type and input to the public model id and documented top-level parameters. Change task_id handling to taskId and adapt the status and webhook response parser.

Is API Stock always cheaper than PiAPI?

No. Compare the exact model, configuration and billing unit in the table. Prices can move in either direction; check both catalogs before sending production traffic.

Can I move every PiAPI workflow?

PiAPI has task types and account-hosting workflows that do not have a direct equivalent here. Migrate supported models individually; a matching model name does not guarantee every task type is available.

What happens to failed or unfinished requests?

Media tasks retry according to the configured routes; a reserve is used when one is available. A terminal generation failure is refunded. Keep polling a processing task instead of creating a duplicate. An expired file URL is not a failed generation.

How do I top up the balance?

Available payment methods, currencies and minimum top-up amounts are shown in your account before payment. There is no subscription: model usage is charged to your prepaid balance.

Try your first request on API Stock

Choose a model, check its parameters and price, then create an API key in your account. Start with one request before moving your traffic.