Images API
Generate high-quality AI images for REPLR avatars, banners, and creative content using our proprietary image generation engine.
https://api.replr.ai/v1Overview
The Images API generates photorealistic and stylized images using REPLR's state-of-the-art image generation model. Images are generated at up to 1024×1024 resolution with style presets optimized for different use cases.
Avatar
Portrait-style character images optimized for profile pictures. 1:1 aspect ratio.
Banner
Wide cinematic landscapes for headers and covers. 16:9 aspect ratio.
Scene
Flexible creative scenes for any use case. Multiple aspect ratios.
Auto-Generated Avatars
When you create a new REPLR without an avatar, we automatically generate a profile picture based on the character's name, tagline, and personality. The avatar appears within a few seconds after creation.
Endpoints
/v1/images/generateAuth RequiredGenerate an AI image from a text prompt. Returns a URL to the generated image.
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | Description of the image to generate (3-500 characters). Be specific about the subject, style, and mood. |
style | string | Optional | Image style preset. Options: "avatar" (portrait, 1:1), "banner" (landscape, 16:9), "scene" (flexible). Defaults to "avatar". |
aspect_ratio | string | Optional | Output aspect ratio. Options: "1:1", "16:9", "9:16", "4:3". Defaults to "1:1". |
Response
{
"url": "https://cdn.replr.ai/generated/img_a1b2c3d4e5f6.png",
"width": 1024,
"height": 1024
}Examples
curl -X POST https://api.replr.ai/v1/images/generate \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A wise old wizard with a long silver beard, mystical blue eyes",
"style": "avatar",
"aspect_ratio": "1:1"
}'Prompt Tips
Be specific
Instead of "a person", try "a young woman with auburn hair, freckles, and green eyes, wearing a leather jacket"
Include mood and lighting
"warm golden hour lighting", "moody neon-lit cyberpunk atmosphere", "soft studio portrait lighting"
Specify art style
"digital painting", "anime style", "photorealistic", "watercolor illustration", "pixel art"
Describe the setting
"in a cozy library", "standing on a mountain peak", "in a futuristic city"
Rate Limits
| Plan | Generations/day | Max resolution |
|---|---|---|
| Free | 5 | 1024 x 1024 |
| Plus | 50 | 1024 x 1024 |
| Pro | 200 | 1024 x 1024 |
| Creator | 500 | 1024 x 1024 |