imfinit Image Generation API

Base

https://imfin.it/api/generate

All examples use the production base. Replace with your custom domain if configured.

Subdomain Shortcut

https://api.imfin.it/prompt/model

Use the api subdomain for clean URLs. The first path segment is the prompt, the second (optional) is the model.

Query parameters

• prompt: Text description of the desired image.
• model: One of gemini | ultra | svg | imagen4 | seedream-4 | nano-banana | nano-banana-pro | nano-banana-2 | gpt-image-2 (legacy nanobanana aliases still work). The nano-banana* models use the Google Generative Language API (set GEMINI_API_KEY); gpt-image-2 is OpenAI’s GPT Image 2 routed through the Vercel AI Gateway.
• ar (or aspect_ratio): Aspect ratio for the generated image, such as 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, etc. Default is 16:9. Supported by: gemini, ultra, imagen4, seedream-4, gpt-image-2, and default flux-1.1-pro models.
• image / image_url / init_image: One or more reference image URLs. Repeat the parameter to pass multiple.
• images: Comma-separated list of image URLs (alternative to repeating image=).
• filename (aliases: name, slug): Friendly name to store the generation under, and to recall later without a prompt.
• ext: When recalling by filename, request a specific format: jpg or png.
• reroll: If true, bypass cache and generate a fresh variation.
• raw: Advanced toggle supported by some models (e.g., ultra).

Color‑coded URL anatomy

https://imfin.it/api/generate?prompt=modern+home&model=seedream-4&ar=16:9&image=https://example.com/a.jpg&image=https://example.com/b.jpg&filename=hero&reroll=true

Change colors indicate different parameter groups: prompt, model, aspect ratio, image(s), caching, and flags.

Examples

1) Text‑to‑image

https://imfin.it/api/generate?prompt=cinematic+sunset+city&model=gemini

2) Image‑guided (single reference, Seedream‑4)

https://imfin.it/api/generate?prompt=enhance+lighting&model=seedream-4&image=https://images.unsplash.com/photo-1503023345310-bd7c1de61c7d?w=1024

3) Image‑guided (multiple references)

https://imfin.it/api/generate?prompt=clean+studio+look&model=seedream-4&image=https://images.unsplash.com/photo-1503023345310-bd7c1de61c7d?w=1024&image=https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=1024

4) Name and recall later

https://imfin.it/api/generate?prompt=hero+bottle+shot&model=seedream-4&filename=hero
https://imfin.it/api/generate?filename=hero

https://imfin.it/api/generate?filename=hero&ext=png

https://imfin.it/api/generate?prompt=cinematic+sunset+city&model=gemini&reroll=true

Parameter‑specific examples

https://imfin.it/api/generate?prompt=minimal+isometric+room&model=gemini
https://imfin.it/api/generate?prompt=macro+photo+dew+drops+on+leaf&model=gemini

https://imfin.it/api/generate?prompt=neon+city&model=ultra&raw=true
https://imfin.it/api/generate?prompt=flat+vector+cat+icon&model=svg
https://imfin.it/api/generate?prompt=clean+product+shot&model=imagen4
https://imfin.it/api/generate?prompt=match+style&model=seedream-4&image=https://images.unsplash.com/photo-1503023345310-bd7c1de61c7d?w=1024
https://imfin.it/api/generate?prompt=fast+sketch+icon&model=nano-banana-2&ar=1:1
https://imfin.it/api/generate?prompt=detailed+poster+with+text&model=nano-banana-pro&ar=3:4
https://imfin.it/api/generate?prompt=poster+with+crisp+small+text&model=gpt-image-2&ar=2:3

https://imfin.it/api/generate?prompt=portrait+photo&model=gemini&ar=9:16
https://imfin.it/api/generate?prompt=square+logo&model=ultra&ar=1:1
https://imfin.it/api/generate?prompt=banner&model=imagen4&ar=21:9
https://imfin.it/api/generate?prompt=classic+photo&model=seedream-4&ar=3:2

https://imfin.it/api/generate?prompt=studio+retouch&model=seedream-4&image=https://example.com/a.jpg
https://imfin.it/api/generate?prompt=studio+retouch&model=seedream-4&image_url=https://example.com/a.jpg
https://imfin.it/api/generate?prompt=studio+retouch&model=seedream-4&init_image=https://example.com/a.jpg
https://imfin.it/api/generate?prompt=studio+retouch&model=seedream-4&images=https://example.com/a.jpg,https://example.com/b.jpg

https://imfin.it/api/generate?prompt=hero+banner&model=gemini&filename=homepage-hero
https://imfin.it/api/generate?filename=homepage-hero
https://imfin.it/api/generate?filename=homepage-hero&ext=png

https://imfin.it/api/generate?prompt=cinematic+sunset+city&model=gemini&reroll=true
https://imfin.it/api/generate?prompt=highly+realistic+portrait&model=ultra&raw=true

Nano Banana models (Google API)

nano-banana, nano-banana-pro, and nano-banana-2 call the Google Generative Language API directly (not Replicate). The deployment must define GEMINI_API_KEY (or GOOGLE_API_KEY / GOOGLE_GENERATIVE_AI_API_KEY). Response Content-Type may be image/png or image/jpeg; X-Model is the Gemini model id (e.g. gemini-2.5-flash-image). Reference URLs: up to 3 for nano-banana, up to 16 for nano-banana-pro and nano-banana-2.

https://imfin.it/api/generate?prompt=nano+banana+still+life&model=nano-banana-2&ar=1:1
https://imfin.it/api/generate?prompt=logo+on+product+mockup&model=nano-banana-pro&image=https://images.unsplash.com/photo-1503023345310-bd7c1de61c7d?w=512

Authentication and credits

If you are logged in, include x-parse-session-token in the request headers to apply credit billing. Insufficient credits return HTTP 402 with a JSON error.

Response headers

• X-Cache-Status: HIT for cached, MISS-GENERATED for fresh generations.
• X-Cache-Store: s3 or fs (local).
• X-S3-Key: S3 object key when applicable.
• X-Model: upstream model identifier (Replicate slug or Gemini model id).
• Content-Disposition: present when filename is supplied (inline with suggested filename).

Errors

• 400 — missing/invalid parameters.
• 402 — insufficient credits.
• 404 — recall by filename not found.
• 502 — upstream model or download failure.