POST
/
v1
/
ai
/
image_generation
import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.image_generation({
  "prompt": "A beautiful sunset over a calm ocean",
  "return_type": "url"
})

{
  "url": "https://jigsawstack-temp.b1e91a466694ad4af04df5d05ca12d93.r2.cloudflarestorage.com/temp/655a787d-cf5a-4fd0-b81b-53c3c9068313.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=7b9a19349842b7b1a9e4c2e19f05b232%2F20250826%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250826T233016Z&X-Amz-Expires=604800&X-Amz-Signature=7e7073e5d88f12c0a7810de51a618ac8c0973ba7ca27d78a1bbb37bc0249c7bd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "_usage": {
        "input_tokens": 18,
        "output_tokens": 75,
        "inference_time_tokens": 3122,
        "total_tokens": 3215
  }
}

​
Request Parameters

​
Body

​
prompt
string
required
The text prompt to generate the image from. Must be between 1-5000 characters.
​
aspect_ratio
string
default:"1:1"
The aspect ratio of the generated image.
  • 1:1
  • 16:9
  • 21:9
  • 3:2
  • 2:3
  • 4:5
  • 5:4
  • 3:4
  • 4:3
  • 9:16
  • 9:21
​
width
number
The width of the image. Must be between 256-1920 pixels.
​
height
number
The height of the image. Must be between 256-1920 pixels.
​
steps
number
default:"4"
The number of denoising steps. Must be between 1-90. Higher values produce better quality images but take more time to generate.
​
output_format
string
default:"png"
The output format of the generated image. Must be one of the following values:
  • png
  • svg
​
url
string
A valid URL where the generated image will be sent.
​
file_store_key
string
Key to store the generated image in file storage.
​
advance_config
object
​
return_type
string
The specified return type for the response
  • url
  • base64
  • binary
​
x-api-key
string
required
Your JigsawStack API key

​
Response

The API returns the generated image directly in the response body as binary data. 
import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.image_generation({
  "prompt": "A beautiful sunset over a calm ocean",
  "return_type": "url"
})

{
  "url": "https://jigsawstack-temp.b1e91a466694ad4af04df5d05ca12d93.r2.cloudflarestorage.com/temp/655a787d-cf5a-4fd0-b81b-53c3c9068313.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=7b9a19349842b7b1a9e4c2e19f05b232%2F20250826%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250826T233016Z&X-Amz-Expires=604800&X-Amz-Signature=7e7073e5d88f12c0a7810de51a618ac8c0973ba7ca27d78a1bbb37bc0249c7bd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "_usage": {
        "input_tokens": 18,
        "output_tokens": 75,
        "inference_time_tokens": 3122,
        "total_tokens": 3215
  }
}