Getting Started
Use GET or POST to generate images with flexible options for batching, dimensions, safety, and inference steps.
Multiple aspect ratios
Square, portrait, landscape, and mobile formats.
Batch generation
Generate 1–6 images in a single request.
Tunable steps
Adjust inference steps 1–15 for quality vs speed.
Safety filtering
Enable optional content safety moderation.
API Endpoints
GET/generate
Example
Generate images using URL query parameters.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
| prompt | string | Yes | Text description of the image | — |
| image | integer | Yes | Number of images (1–6) | — |
| dimensions | string | Yes | Image dimensions (see below) | — |
| safety | boolean | No | Enable safety filtering | false |
| steps | integer | No | Inference steps (1–15) | 4 |
Swipe table horizontally on smaller screens.
Example
GET /generate?prompt=beautiful%20sunset&image=2&dimensions=16:9&safety=true&steps=8POST/generate
Body
Generate images using a JSON request body.
Request Body (JSON)
{
"prompt": "beautiful sunset over mountains",
"image": 2,
"dimensions": "16:9",
"safety": true,
"steps": 8
}Available Dimensions
| Key | Aspect Ratio | Resolution | Description |
|---|---|---|---|
| 1:1 | Square | 1024x1024 | Perfect square |
| 1:2 | Portrait | 512x1024 | Tall portrait |
| 3:2 | Landscape | 768x512 | Classic photo ratio |
| 3:4 | Portrait | 768x1024 | Standard portrait |
| 16:9 | Widescreen | 1024x576 | Widescreen format |
| 9:16 | Mobile | 576x1024 | Mobile / story |
| tall | Portrait | 576x1024 | Alias for 9:16 |
| wide | Landscape | 1024x576 | Alias for 16:9 |
| square | Square | 1024x1024 | Alias for 1:1 |
Swipe table horizontally on smaller screens.
Response Format
JSON Response
{
"images": [
"https://uguu.se/ar_abc123.png",
"https://uguu.se/ar_def456.png"
],
"Try": "Try Our own hosting service at https://ar-hosting.pages.dev/",
"join": "-@Ashlynn_Repository"
}Error Responses
Example Error
{
"error": "Invalid request parameters. Please check your input and try again."
}Ready to build?
Explore the playground and ship your first image in seconds.