POST
/
v1
/
vocr

Body

prompt
string | Array<string>

The prompt used to describe the image. Default prompt is Describe the image in detail.

url
string

The image url. Not required if file_store_key is specified.

file_store_key
string

The key used to store the image on Jigsawstack File Storage. Not required if url is specified.

page_range
Array<number>

Specifies a range of pages to process with vOCR, provided as a two-element array: [startPage, endPage]. For example, [1,10] processes pages 1 through 10. The range must span 10 or fewer pages. If the specified endPage exceeds the document’s total pages, the last available page will be used instead. Both startPage and endPage are inclusive and must be positive integers where startPage ≤ endPage.

Either url or file_store_key should be provided not both.

Prompt Example

  • String
{
  prompt: "Describe the image in detail.";
}
  • Array<String>

Use this approach to retrieve specific data from the image file.

{
  prompt: ["first name", "last name"];
}
x-api-key
string
required

Your JigsawStack API key

Response

success
boolean

Indicates whether the call was successful.

Supported file types: - Images: JPEG, JPG, PNG - Documents: Multi-page PDFs (up to 10 pages per API request)