Produce product and marketing visuals
Generate images from a prompt at a size from 256 to 2048 pixels, and request up to 4 samples per call.
POST /api/v1/ai/images
AI Image Generation API
Generate images from a text prompt, then download the stored image file by job ID.
4 endpoints · 1 credit = $0.001. Each endpoint has its own credit cost, listed below. Calls that fail because of a service error are refunded.
API workspace and documentation
AI Image Generation
Free Trial: 50 of 50 left
Select API to test:
AI Image Generation
Job Queue & History
0
No jobs in queue yet. Generate a new image!
AI models understand English best
Style presets:
Aspect Ratio:
None
Selected Base Image:
Select an image from left list to edit
Job ID: —
Editing from your source image...
Job ID:
—
succeeded
Resolution: 1024 × 1024
|
PNG
Ready
?
?
No request yet. Run a test to see the actual response.
What you can build with the AI image generation API
The AI image generation API creates an image from a text prompt. Each call returns a job ID, and the result stays available for download under that ID for a limited time.
Create covers and thumbnails for each post
Send one prompt per article title from your CMS, then download each artifact by job ID and store it next to the post.
POST /api/v1/ai/images
Plug image generation into a workflow
Call the API from your backend, download the artifact by job ID and store it in your own storage before it expires.
GET /api/v1/ai/images/{job}
How the AI image generation API works
-
1
Generate
POST /api/v1/ai/images with a prompt (up to 2,000 characters) and optional width, height and samples. Keep the job ID.
-
2
Check the job (optional)
GET /api/v1/ai/images/{job} returns its status and when it expires.
-
3
Download the image
GET /api/v1/ai/images/{job}/artifact returns the image file. DELETE removes the stored job data.
Try the AI Image Generation API with your own account
New accounts receive 1,000 credits after verification, enough for about 125 calls to "AI Image Generation".
Using AI Image Generation
Generate from a prompt using the inputs documented for the operation.
Keep the returned job ID to inspect its state or retrieve the artifact. Examples do not create a live job.
Preview and download the returned image. Cancel removes the stored job data according to the endpoint behavior; it does not promise upstream cancellation.
AI image generation API endpoints and pricing
OpenAPI 3.1 JSONSelect an operation above and open API & Docs for parameters and cURL, JavaScript, Python or PHP examples. The web tool uses your signed-in session; external integrations use a Bearer API key.
| Method | Endpoint | Cost |
|---|---|---|
| POST |
AI Image Generation
/api/v1/ai/images
Try it
Helpful?
|
8 credit / image≈ $0.008 |
| GET |
AI Image Job Status
/api/v1/ai/images/{job}
Try it
Helpful?
|
0 credit / request |
| GET |
Download AI Image Artifact
/api/v1/ai/images/{job}/artifact
Try it
Helpful?
|
0 credit / request |
| DELETE |
Cancel AI Image Job
/api/v1/ai/images/{job}
Try it
Helpful?
|
0 credit / request |
AI image generation API: frequently asked questions
What is the AI image generation API?
It is a text to image API: send a prompt and download the picture by job ID. If you need an AI image generator for products, banners or automated workflows, this is the endpoint to call.
How long can I download a result?
Each call is stored as a job with an expiry date, returned by the job endpoint. Download the artifact and keep your own copy.
How many images can I request at once?
Between 1 and 4 samples per request.
Does cancelling stop the upstream work?
Cancel removes the stored job data according to the endpoint behavior. It does not promise that upstream processing stops.
How is it billed?
Per generated image. Checking a job, downloading the artifact and cancelling are free. See the endpoint table below. New accounts receive 1,000 credits after verification.
Before integrating
Live and example data
Check the Live or Sandbox label before running. Examples demonstrate the response structure and do not guarantee live service status.
Credits and limits
Pricing depends on the endpoint and billable units. Failed live requests are not replaced with billable examples. Check your account limits before running repeated requests.
View pricingHandling errors
Keep the request ID for troubleshooting. For 429, respect Retry-After when provided. If a create or delete request loses its connection, check the resource state before retrying.
Related APIs
All APIs-
Content & AI Writing
13 endpointsGrammar checking, AI text generation, text-to-speech and YouTube transcripts through one normalized interface.
View Content & AI Writing API → -
Shopify & Marketplace Catalog
1 endpointsRead the public product catalog of a Shopify store: products, variants, prices, availability and images, with pagination.
View Shopify & Marketplace Catalog API → -
Community & Open Feeds
16 endpointsTelegram channels preview, Discord invites, Hacker News, Pinterest, Bluesky, Mastodon, Substack, Twitch.
View Community & Open Feeds API →
Often used together: Text to Speech API & YouTube Transcript API · Shopify Product Scraper API · Bluesky API, Telegram API & More
Ready to integrate the AI Image Generation API? Create an account and get your API key in minutes.