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 documentationScroll horizontally to read all table columns.
| Integration detail | PiAPI | API Stock |
|---|---|---|
| Request | POST /api/v1/task | POST /api/v1/generation/create |
| Authentication | X-API-Key | Authorization: Bearer |
| Model identifier | model: gemini / task_type: gemini-2.5-flash-image | nano-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.
| Model | API Stock | PiAPI | Our price difference |
|---|---|---|---|
| Nano Bananaper image · text to image | API Stock$0.015 | PiAPI$0.03 | 50% lower |
| Nano Banana Pro1K · per image · text to image | API Stock$0.04 | PiAPI$0.105 | 61.9% lower |
| Nano Banana Pro4K · per image · text to image | API Stock$0.05 | PiAPI$0.18 | 72.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.
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
Create an account, top up your prepaid balance and issue an API key.
2
POST to /api/v1/generation/create with the public model id and its documented parameters. Each task generates one output.
3
Read taskId from the response. Poll GET /api/v1/task/status/TASK_ID, or set webhook in the creation request.
PiAPI
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
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.
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.