Generate
stunning images
via API.
Professional async image generation with wallet-based billing, multi-token management, and S3 storage. Built for developers who ship fast.
curl -X POST https://api.sharkapi.dev/v1/generate \
-H "Authorization: Bearer sk_live_••••••••" \
-H "Content-Type: application/json" \
-d '{
"mode": "2k",
"prompt": "Deep ocean shark, cinematic, 8K"
}'{
"job_id": "job_8f2a9d3c",
"status": "queued",
"estimated_cost": "$0.02",
"poll_url": "/v1/jobs/job_8f2a9d3c"
}How it works
From sign-up to image URL in six clean steps.
Sign up
Create your account and receive 3 free trial generations instantly.
Get token
Auto-generate your first API token on onboarding. Create more anytime.
Add balance
Top up your wallet with $10 minimum. Only charged on successful jobs.
Send request
POST to /v1/generate with your prompt, mode, and optional image.
Poll status
Receive a job_id. Poll /v1/jobs/:id every 2 seconds until complete.
Receive image
Get the S3 image URL. Wallet deduction finalizes only at this point.
Pay only for what you generate
Wallet-based. Only charged on successful jobs. Failed jobs cost nothing.
1K Mode
2K Mode
Minimum wallet top-up $10 · Only $10 multiples accepted
Built for production
Enterprise-grade image API with the simplicity of a weekend project.
Async generation
Submit and poll. Never block your server waiting for image completion.
Wallet billing
Pre-load balance. Charged only when image_url is confirmed delivered.
Multiple API tokens
Create named tokens per project. Revoke instantly without rotating others.
Text + image input
Send text prompts, or combine with a reference image for guided output.
Full request history
Every job logged with status, cost, mode, token, and moderation result.
Moderation system
Built-in illegal content detection blocks harmful prompts before generation.
Integrate in 60 seconds
Three steps from any language to your first generated image.
curl -X POST https://api.sharkapi.dev/v1/generate \
-H "Authorization: Bearer sk_live_••••••••" \
-H "Content-Type: application/json" \
-d '{
"mode": "2k",
"prompt": "Deep ocean shark, cinematic lighting, 8K"
}'3 free image generations. No card required.
Every account gets 3 complimentary generations on-site. Test 1K and 2K modes before adding any balance.
Ready to dive in?
Join developers building with SharkApi.dev. Start with 3 free generations — no credit card required.