ArtGen
### Why ArtGen? * **Unique Every Time:** Use stochastic and geometric algorithms to ensure no two banners are exactly alike. * **Fully Customizable:** Control everything from color palettes and geometric density to "Art Types" like **Ribbons**, **Topography**, and **Shattered Polygons**. * **High-Resolution Output:** Supports industry presets (Twitter, LinkedIn, A4) and custom dimensions up to…
ArtGen endpoints
| Method | Endpoint | Description |
|---|---|---|
| banners | ||
| GET |
regenerate_banner_url_v1_banners__banner_id__url_get /v1/banners/{banner_id}/url |
Generate a fresh signed URL for an existing banner. Use this endpoint when your previous image URL has expired (URLs are valid for 24 hours). **Response includes**: -… |
| POST |
generate_banner_v1_generate_post /v1/generate |
Generate a new procedural banner artwork with specified parameters. ## Art Types | Art Type | Description | Variants | Special Parameters |… |
| GET |
get_banner_v1_banners__banner_id__get /v1/banners/{banner_id} |
Retrieve a specific banner by its unique identifier. Returns the banner metadata including a **fresh signed image URL** valid for 24 hours. **Note**: Banners are public by ID but… |
| POST |
Generate Random Banner /v1/generate/random |
Generate a banner with a randomly selected art type and color palette. Size is required - use either size_preset (recommended) or legacy size parameter. Size Options Use… |
| configuration | ||
| GET |
get_sizes_v1_config_sizes_get /v1/config/sizes |
Get available banner sizes grouped by category. ## Size Categories ### Digital Display (IAB Standard Sizes) Standard advertising sizes for web display: - `medium_rectangle`… |
| GET |
get_full_configuration_v1_config_get /v1/config |
Get complete API configuration including all available options for banner generation. This is the recommended endpoint for discovering all available options in a single request.… |
| GET |
get_art_types_v1_config_art_types_get /v1/config/art-types |
Get available art generation algorithms with their parameters and variants. ## Art Types Overview | Art Type | Variants | Special Parameters |… |
| GET |
get_palettes_v1_config_palettes_get /v1/config/palettes |
Get list of available color palettes for banner generation. ## Available Palettes (26 total) | Category | Palettes | |----------|----------| | **Nature** | `forest`, `ocean`,… |
| images | ||
| GET |
get_image_v1_images__banner_id__get /v1/images/{banner_id} |
Retrieve a banner image using a signed URL. ## Authentication This endpoint requires valid `expires` and `signature` query parameters that are included in the signed URLs… |
| queue | ||
| GET |
get_queue_status_v1_queue_status__request_id__get /v1/queue/status/{request_id} |
Get the status of a queued banner generation request. Use this endpoint to check if your request is still queued, currently processing, or completed. **Status Values**: -… |
ArtGen pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $4.99 / month | — |
|