API Usage

Basic Usage

Use your unique token to generate images with a simple URL that includes the description of the image:

Example: A cute puppy

Required parameter:

description=A cute puppy
https://instashotsai.com/g/YOUR_TOKEN?description=A cute puppy

Image Size

Control the aspect ratio of your generated images:

Square image example

Square (Default)

size=square
https://instashotsai.com/g/YOUR_TOKEN?description=An+abstract+blue+background+pattern&size=square
Landscape image example

Landscape

size=land
https://instashotsai.com/g/YOUR_TOKEN?description=A+product+team+discussing+app+mockups&size=land
Portrait image example

Portrait

size=port
https://instashotsai.com/g/YOUR_TOKEN?description=An+astronaut+in+the+dessert&size=port

Image Filters

Apply filters to transform your images on-the-fly:

Black and white filter example

Grayscale

filters=bw
https://instashotsai.com/g/YOUR_TOKEN?description=Photorealistic+dessert+dunes&filters=bw
Blur filter example

Blur

filters=blur
https://instashotsai.com/g/YOUR_TOKEN?description=A+cityscape&filters=blur
Multiple filters example

Combined Filters

filters=bw,blur
https://instashotsai.com/g/YOUR_TOKEN?description=A+forest+scene&filters=bw%2Cblur

You can combine multiple filters by separating them with commas as shown in the Combined Filters example.

Wait for Generation

By default, requests return immediately with a placeholder if the image is still being generated. Add the wait=true parameter to wait for the image generation to complete (timeout: 30 seconds).

wait=true
https://instashotsai.com/g/YOUR_TOKEN?description=A+cute+puppy&wait=true

Note

Image generation is subject to rate limiting based on your subscription plan. Check your account dashboard for your current usage and limits.