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

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

const response = await jigsaw.summary({
  "text": "The Leaning Tower of Pisa, or simply, the Tower of Pisa, is the campanile, or freestanding bell tower, of Pisa Cathedral. It is situated behind the Cathedral and is the third-oldest structure in the city's Cathedral Square, after the Cathedral and the Baptistry. The tower's tilt began during construction in the 12th century, caused by an inadequate foundation on ground too soft on one side to properly support the structure's weight. The tilt increased in the decades before the structure was completed in the 14th century. It gradually increased until the structure was stabilized by efforts in the late 20th and early 21st centuries. The height of the tower is 55.86 metres (183.27 feet) from the ground on the low side and 56.67 metres (185.93 feet) on the high side. The width of the walls at the base is 2.44 m (8 ft 0.06 in). Its weight is estimated at 14,500 tonnes. The tower has 296 or 294 steps; the seventh floor has two fewer steps on the north-facing staircase.",
  "type": "points",
  "max_points": 3
})

{
  "success": true,
  "summary": [
        "The Leaning Tower of Pisa is the freestanding bell tower of Pisa Cathedral and the third-oldest structure in the city's Cathedral Square.",
        "The tower's tilt started in the 12th century due to a weak foundation on soft ground.",
        "The tower is approximately 55-57 meters tall, with a weight of around 14,500 tonnes, and has about 294-296 steps."
  ],
  "_usage": {
        "input_tokens": 256,
        "output_tokens": 93,
        "inference_time_tokens": 1345,
        "total_tokens": 1694
  }
}

​
Request Parameters

​
Body

​
text
string
The text content to summarize. Maximum 300,000 characters. Not required if url or file_store_key is specified.
​
url
string
URL of a PDF document to summarize. Not required if text or file_store_key is provided.
​
file_store_key
string
The key of a stored PDF document to summarize from Jigsawstack File Storage. Not required if text or url is provided.
​
type
string
default:"text"
The format of the summary: - text: Returns a continuous paragraph summary - points: Returns bullet points as an array of strings
​
max_points
number
default:"2"
The maximum number of bullet points to generate when type is set to points. Maximum value is 100.
​
max_characters
number
The maximum number of characters in the generated summary.
​
x-api-key
string
required
Your JigsawStack API key

​
Response Structure

The response structure varies based on the type parameter:
​
success
boolean
Indicates whether the call was successful.
​
_usage
object
Usage information for the API call.

​
When type is “text” (default)

​
summary
string
The generated summary as a continuous paragraph.

​
When type is “points”

​
summary
string[]
An array of strings, where each string represents a bullet point in the summary.
import { JigsawStack } from "jigsawstack";

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

const response = await jigsaw.summary({
  "text": "The Leaning Tower of Pisa, or simply, the Tower of Pisa, is the campanile, or freestanding bell tower, of Pisa Cathedral. It is situated behind the Cathedral and is the third-oldest structure in the city's Cathedral Square, after the Cathedral and the Baptistry. The tower's tilt began during construction in the 12th century, caused by an inadequate foundation on ground too soft on one side to properly support the structure's weight. The tilt increased in the decades before the structure was completed in the 14th century. It gradually increased until the structure was stabilized by efforts in the late 20th and early 21st centuries. The height of the tower is 55.86 metres (183.27 feet) from the ground on the low side and 56.67 metres (185.93 feet) on the high side. The width of the walls at the base is 2.44 m (8 ft 0.06 in). Its weight is estimated at 14,500 tonnes. The tower has 296 or 294 steps; the seventh floor has two fewer steps on the north-facing staircase.",
  "type": "points",
  "max_points": 3
})

{
  "success": true,
  "summary": [
        "The Leaning Tower of Pisa is the freestanding bell tower of Pisa Cathedral and the third-oldest structure in the city's Cathedral Square.",
        "The tower's tilt started in the 12th century due to a weak foundation on soft ground.",
        "The tower is approximately 55-57 meters tall, with a weight of around 14,500 tonnes, and has about 294-296 steps."
  ],
  "_usage": {
        "input_tokens": 256,
        "output_tokens": 93,
        "inference_time_tokens": 1345,
        "total_tokens": 1694
  }
}