imfinit Image Generation API

Base

https://imfin.it/api/generate

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

Query parameters

• prompt: Text description of the desired image.
• model: One of gemini | ultra | svg | imagen4 | seedream-4 | nanobanana.
• 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, 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=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

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.
• 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.