StageSnap Developer API
Image generation and editing, video, music, avatars, upscalers — the whole frontier catalog behind one key, at roughly half official API rates. Per-call prices in prepaid credits, works with any StageSnap plan — and your AI assistant can drive it for you.
1 credit = $0.01 · Failed calls auto-refund · Keys in your settings
$ curl https://www.stagesnap.ai/api/v1/proxy/generate \
-H "Authorization: Bearer sk_live_…" \
-d '{
"model": "nano-banana-2",
"input": {
"prompt": "Stage this empty living room in warm modern style",
"image_url": "https://example.com/living-room.jpg"
}
}'
// 6 credits — $0.06
{ "taskId": "task_01hx4k9v2e8q", "creditsCharged": 6 }
$ curl …/api/v1/proxy/tasks/task_01hx4k9v2e8q
{ "status": "succeeded", "output": { "images": [ … ] } }If you use Claude, ChatGPT, or Cursor, you already have a developer on staff. Hand it this API and it can generate listing images and video for you on demand — at published per-call prices, with any StageSnap plan. Create a key in Settings, top up API credits, and pay only for what you generate. No extra subscription.
The button below copies everything your AI needs to know — endpoints, models, prices.
Claude, ChatGPT, or Cursor — whichever assistant you already talk to.
“Stage this photo,” “make a five-second walkthrough.” It knows how.
Fixed prices on the models you’ll call most; everything else on the KIE.ai catalog is metered at actual cost. The price is always visible before the call.
nano-banana-2
Google image editing — photoreal edits that preserve room structure.
gpt-image-2
OpenAI image generation with strong prompt-following for graphics.
kling-2.5
Cinematic image-to-video — smooth camera moves through rooms.
veo-3.1
Google video with native audio — walkthroughs that sound real.
seedance
ByteDance video — fast multi-shot generation for social cuts.
hailuo
MiniMax video — smooth, natural motion through interior spaces.
wan
Alibaba video — strong motion and structure preservation.
music
Suno-class full songs — original listing tracks with vocals.
avatars
Presenter-style avatar video for agent intros and market updates.
upscalers
Print-resolution enlargement for flyers, postcards, and signage.
Metered models use reserve-then-settle: a reserve is held when the task starts and the final charge settles to the provider’s actual cost — capped, never above the reserve. The current fixed-price table always lives in llms.txt.
Create a key, post a job, poll the task. That’s the whole integration.
Step 1
In Settings → API Keys. Shown once — copy it somewhere safe.
Your new key
sk_live_9f3c…e81a
Send it as Authorization: Bearer
Step 2
POST /api/v1/proxy/generate with a model and its input. The response is your receipt.
{
"model": "nano-banana-2",
"input": { "prompt": "…",
"image_url": "…" },
"idempotencyKey": "job-8412"
}
→ {
"taskId": "task_01hx4k9v2e8q",
"creditsCharged": 6
}Step 3
GET /api/v1/proxy/tasks/{taskId} until it succeeds. Seconds for images, minutes for video.
{
"taskId": "task_01hx4k9v2e8q",
"status": "succeeded",
"creditsCharged": 6,
"output": {
"images": [ { "url": "…" } ]
}
}Top up a credit pack, spend it call by call. No subscription, no expiry games, no surprise line items — the price of every call is published before you make it.
1,000
credits
$10
$1.00 per 100 credits
5,000
credits
$45
$0.90 per 100 credits
20,000
credits
$160
$0.80 per 100 credits
The same create → poll loop in curl, JavaScript, and Python — copy-paste correct against the live contract.
# 1. Create a task
curl https://www.stagesnap.ai/api/v1/proxy/generate \
-H "Authorization: Bearer $STAGESNAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"input": {
"prompt": "Stage this empty living room in warm modern style",
"image_url": "https://example.com/living-room.jpg"
},
"idempotencyKey": "job-8412"
}'
# → { "taskId": "task_01hx4k9v2e8q", "creditsCharged": 6 }
# 2. Poll until status is "succeeded"
curl https://www.stagesnap.ai/api/v1/proxy/tasks/task_01hx4k9v2e8q \
-H "Authorization: Bearer $STAGESNAP_API_KEY"
# 3. Check your balance
curl https://www.stagesnap.ai/api/v1/proxy/balance \
-H "Authorization: Bearer $STAGESNAP_API_KEY"One click copies our entire API reference. Paste it into Claude, Cursor, or ChatGPT and ask for the integration you want — your assistant has the full contract, prices included.
You prepay for API credits — 1 credit is one US cent. Hero models have fixed per-call prices (shown before you call), and every other model is metered: a reserve is held when the task starts and the final charge settles to the actual provider cost, never above the reserve. There is no subscription and no monthly minimum.
You get the credits back automatically — the full charge, not a partial. A failed task shows status "failed" with the error, and its creditsCharged drops to 0 once the refund lands. You only ever pay for output.
Twenty requests per ten seconds per key. Exceeding it returns HTTP 429; back off and retry after the window resets. Polling counts, so poll on a shared interval rather than one timer per task.
In your StageSnap account under Settings → API Keys. Keys are shown once at creation, so copy them somewhere safe — and keep them server-side, never in client code.
No. The Developer API bills purely from your prepaid credit balance. A StageSnap plan covers the app; the API is its own pay-as-you-go lane, so you can build on it with just an account and a credit pack.
Every model on the KIE.ai catalog — frontier image generation and editing, video, music, talking avatars, and upscalers — through the same endpoint and the same key. New models appear on the proxy as the catalog adds them; the llms.txt reference always lists the current fixed-price table.