v1REST API

API Reference

Integrate imgeo's AI image generation into your own applications. Access 14+ models, text-to-image and image-to-image modes — all through a simple REST API with pay-per-use credits.

POST/api/v1/generate GET/api/v1/models GET/api/v1/balance

Quick Start

Get up and running in 3 steps

1Get Credits

Buy credits on the Pricing page — or start with 10 free credits on sign-up.

2Create API Key

Go to Dashboard → API Keys → Create New Key. Save it securely.

3Make a Request

Send a POST request to /api/v1/generate with your prompt and API key.

Authentication

Bearer token in the Authorization header

Every request (except GET /models) must include your API key:

Header

1Authorization: Bearer imgeo_sk_YOUR_KEY

Security tip: Never expose your API key in client-side code. Always call the API from a server or backend.

POST /api/v1/generate

Generate images from text prompts

POSThttps://www.imgeo.club/api/v1/generate

Request Body (JSON)

Parameter	Type	Required	Description
model	string	required	Model ID (see Available Models below)
prompt	string	required	Text description of the image to generate (max 2 000 chars)
negative_prompt	string	optional	What to exclude from the image (supported models only)
aspect_ratio	string	optional	Aspect ratio — default "1:1". Options: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
count	number	optional	Number of images (default 1, max varies by model)
mode	string	optional	"text2img" (default) or "img2img"
image	string	optional	Public image URL for img2img mode

Examples

1curl -X POST https://www.imgeo.club/api/v1/generate \

2 -H "Authorization: Bearer imgeo_sk_YOUR_KEY" \

3 -H "Content-Type: application/json" \

4 -d '{

5 "model": "black-forest-labs/flux-schnell",

6 "prompt": "A cat sitting on a rainbow cloud, digital art",

7 "aspect_ratio": "1:1",

8 "count": 1

9 }'

Response

200 OK

2 "images": [

3 "https://pub-xxx.r2.dev/generations/uid/1234567890-0.webp"

4 ],

5 "model": "black-forest-labs/flux-schnell",

6 "prompt": "A cat sitting on a rainbow cloud, digital art",

7 "aspect_ratio": "1:1",

8 "credits_used": 1,

9 "credits_remaining": 109

10}

GET /api/v1/models

List all available models and their capabilities

GEThttps://www.imgeo.club/api/v1/models

No authentication required. Returns an array of model objects with IDs, supported modes, aspect ratios, and credit costs.

cURL

1curl https://www.imgeo.club/api/v1/models

GET /api/v1/balance

Check your current credit balance

GEThttps://www.imgeo.club/api/v1/balance

Requires authentication. Returns your remaining credit balance.

cURL

1curl https://www.imgeo.club/api/v1/balance \

2 -H "Authorization: Bearer imgeo_sk_YOUR_KEY"

200 OK

1{ "credits": 109 }

Available Models

14+ models with per-image credit costs

Model ID	Name	Credits	Modes	Neg. Prompt
stability-ai/sdxl	SDXL	2	text2img, img2img	Yes
black-forest-labs/flux-kontext-max	Flux Kontext Max	9	text2img, img2img	No
google/nano-banana	Nano Banana	7	text2img, img2img	Yes
google/nano-banana-pro	Nano Banana Pro	10	text2img, img2img	Yes
bytedance/seedream-4	Seedream 4	5	text2img, img2img	Yes
black-forest-labs/flux-schnell	Flux Schnell	1	text2img	No
prunaai/flux-fast	Flux Fast	2	text2img	No
black-forest-labs/flux-dev	Flux Dev	5	text2img	No
qwen/qwen-image	Qwen Image	5	text2img	Yes
bytedance/seedream-4.5	Seedream 4.5	7	text2img	Yes
google/imagen-4	Imagen 4	7	text2img	Yes
google/imagen-3	Imagen 3	9	text2img	Yes
black-forest-labs/flux-pro	Flux Pro	9	text2img	No
stability-ai/stable-diffusion-3.5-large	SD 3.5 Large	9	text2img	Yes

Error Codes

HTTP status codes and their meaning

Status	Meaning	Description
400	Bad Request	Invalid parameters or missing required fields.
401	Unauthorized	Missing or invalid API key.
402	Payment Required	Insufficient credits — purchase more on the Pricing page.
500	Server Error	Generation failed. Credits are automatically refunded.

FAQ

Common questions about the API

How do I get an API key?

Log in to your imgeo account → Dashboard → "API Keys" section → Create new key. The key is shown only once — save it securely.

Are API credits separate from web credits?

No. API and website share the same credit balance. Purchase credits on the Pricing page and use them anywhere.

Is there a rate limit?

There is no strict rate limit at this time. We reserve the right to throttle excessive traffic. Enterprise plans include dedicated rate limits.

How long are generated images stored?

Images are stored permanently on Cloudflare R2. URLs do not expire.

What happens if generation fails?

Credits are automatically refunded. The API returns HTTP 500 with an error message.

Can I use the API for commercial purposes?

Yes. All generated images may be used commercially. Please review our Terms of Service for full details.

Ready to start building?

Create your API key and generate your first image in seconds.

Go to Dashboard View Pricing