Free estimate for one PDF

POST

/api/v1/convert/estimate

curl --request POST \
  --url https://api.gevell.com/api/v1/convert/estimate \
  --header 'Content-Type: application/pdf' \
  --header 'X-API-Key: <X-API-Key>' \
  --data binary

• Production

Page count, price at your account’s rate and balance (net of your other jobs’ active reservations). Makes no AI call and stores nothing. Limited to 120 requests per hour per account. Body limit: 25 MB on api.gevell.com; about 4.5 MB through api-pdf.gevell.com (Lambda).

Authorizations

• apiKey

Request Body^required

string format: binary

object

inputKey

From POST /api/v1/tagging/uploads.

string

Example^generated

{
  "inputKey": "example"
}

Responses

200

Estimate

Media typeapplication/json

object

success

boolean

data

object

pages

integer

pageCountKnown

boolean

startable

False when the page count cannot be read; a start refuses such a file (422).

boolean

mode

How converting is metered for this account.

string

nullable

affordable

boolean

cost

Cents (pay-as-you-go) or pages (plan).

number

available

Balance net of your other jobs’ active reservations.

number

unitPriceCents

number

nullable

shortfall

0 when affordable.

number

reason

string

nullable

purchaseUrl

string format: uri

billedPerPage

boolean

estimatedWaitSeconds

integer

defaultOutputs

What to deliver. Default ["pdf","conformance"]. pdf and conformance come together; add html for the accessible HTML.

Array<string>

<= 3 items

Allowed values: html pdf conformance

worstCase

The most a start can be charged. Conversion is a flat per-page charge, so it equals cost; pages that fail to convert are not billed.

object

pages

integer

cost

number

unitPriceCents

number

nullable

Example

{
  "data": {
    "defaultOutputs": [
      "html"
    ]
  }
}

401

Missing or invalid API key

Media typeapplication/json

object

success

boolean

error

object

code

string

message

string

details

object

key

additional properties

any

Example

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS"
  }
}

403

InputKey is outside your own storage prefix

Media typeapplication/json

object

success

boolean

error

object

code

string

message

string

details

object

key

additional properties

any

Example

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS"
  }
}

404

InputKey not found

Media typeapplication/json

object

success

boolean

error

object

code

string

message

string

details

object

key

additional properties

any

Example

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS"
  }
}

413

PDF over 25 MB (FILE_TOO_LARGE or PAYLOAD_TOO_LARGE)

Media typeapplication/json

object

success

boolean

error

object

code

string

message

string

details

object

key

additional properties

any

Example

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS"
  }
}

422

Encrypted or unreadable PDF

Media typeapplication/json

object

success

boolean

error

object

code

string

message

string

details

object

key

additional properties

any

Example

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS"
  }
}

429

Estimate limit reached

Media typeapplication/json

object

success

boolean

error

object

code

string

message

string

details

object

key

additional properties

any

Example

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS"
  }
}