Input

prompt

string

Shift + Return to add a new line

The text prompt to generate the image from. Must be between 1-5000 characters.

Default: ""

aspect_ratio

string

The aspect ratio of the generated image

Default: "1:1"

width

integer

The width of the image. Must be between 256-1920 pixels.

height

integer

The height of the image. Must be between 256-1920 pixels.

steps

integer

(minimum: 1, maximum: 90)

The number of denoising steps. Must be between 1-90. Higher values produce better quality images but take more time to generate.

Default: 4

output_format

string

The output format of the generated image

Default: "png"

url

string

Shift + Return to add a new line

A valid URL where the generated image will be sent

file_store_key

string

Shift + Return to add a new line

Key to store the generated image in file storage

negative_prompt

string

Shift + Return to add a new line

Text describing what you don't want in the image

guidance

number

(minimum: 1, maximum: 28)

Higher guidance forces the model to better follow the prompt, but may result in lower quality output. Must be between 1-28.

seed

integer

Makes generation deterministic. Using the same seed and set of parameters will produce identical image each time.

api_key

string

Shift + Return to add a new line

sk_ba8d51db7829aef7ec445bb80dd59b7ff2c320d851eb6ae4cf41aacfab4df81c690774957983ebcc02f08429fccdfe42b4d8ee6a40b404399c10ca3bcabdbb72024KnIELzWIzzblw1gtM6sk_ba8d51db7829aef7ec445bb80dd59b7ff2c320d851eb6ae4cf41aacfab4df81c690774957983ebcc02f08429fccdfe42b4d8ee6a40b404399c10ca3bcabdbb72024KnIELzWIzzblw1gtM6

🔐 Your JigsawStack API Key (required)

Run this model in Node.js with one line of code:

npx create-replicate --model=jigsawstack/image-generation

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";
import fs from "node:fs";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run jigsawstack/image-generation using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "jigsawstack/image-generation:43d5bce2e1c97fa1e7d8996187a85cd5c882787989091af3b135c7a16ca23b79",
  {
    input: {
      steps: 4,
      prompt: "Generate me an image of ocean",
      api_key: "sk_ba8d51db7829aef7ec445bb80dd59b7ff2c320d851eb6ae4cf41aacfab4df81c690774957983ebcc02f08429fccdfe42b4d8ee6a40b404399c10ca3bcabdbb72024KnIELzWIzzblw1gtM6",
      aspect_ratio: "16:9",
      output_format: "png"
    }
  }
);

// To access the file URL:
console.log(output.url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run jigsawstack/image-generation using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "jigsawstack/image-generation:43d5bce2e1c97fa1e7d8996187a85cd5c882787989091af3b135c7a16ca23b79",
    input={
        "steps": 4,
        "prompt": "Generate me an image of ocean",
        "api_key": "sk_ba8d51db7829aef7ec445bb80dd59b7ff2c320d851eb6ae4cf41aacfab4df81c690774957983ebcc02f08429fccdfe42b4d8ee6a40b404399c10ca3bcabdbb72024KnIELzWIzzblw1gtM6",
        "aspect_ratio": "16:9",
        "output_format": "png"
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run jigsawstack/image-generation using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "jigsawstack/image-generation:43d5bce2e1c97fa1e7d8996187a85cd5c882787989091af3b135c7a16ca23b79",
    "input": {
      "steps": 4,
      "prompt": "Generate me an image of ocean",
      "api_key": "sk_ba8d51db7829aef7ec445bb80dd59b7ff2c320d851eb6ae4cf41aacfab4df81c690774957983ebcc02f08429fccdfe42b4d8ee6a40b404399c10ca3bcabdbb72024KnIELzWIzzblw1gtM6",
      "aspect_ratio": "16:9",
      "output_format": "png"
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

Generated in

1.8 seconds

Tweak it ShareReport View full prediction

Examples

View more examples

Run time and cost

This model runs on CPU hardware. We don't yet have enough runs of this model to provide performance information.

Readme

🖼️ JigsawStack Image Generation

This model wraps the JigsawStack Image Generation API and allows you to generate high-quality images from text prompts using Replicate.

📦 It supports advanced controls like custom dimensions, guidance scale, negative prompts, and deterministic seeding.

🚀 What It Does

You provide a text prompt (and optionally, aspect ratio, resolution, etc.), and the model returns a generated image using JigsawStack’s hosted API.

🔑 Inputs

Name	Type	Required	Description
`prompt`	string	✅ Yes	Text to guide image generation
`api_key`	string	✅ Yes	Your JigsawStack API key
`aspect_ratio`	string	❌ No	Aspect ratio (default: `1:1`)
`width`	int	❌ No	Image width (256–1920)
`height`	int	❌ No	Image height (256–1920)
`steps`	int	❌ No	Generation steps (default: `4`)
`output_format`	string	❌ No	Output format (`png`, `svg`)
`negative_prompt`	string	❌ No	What not to include
`guidance`	float	❌ No	Prompt adherence (1–28)
`seed`	int	❌ No	Deterministic seed
`url`	string	❌ No	Optional webhook for generated image
`file_store_key`	string	❌ No	Key to save output on your file storage