Get started¶
This section takes you from nothing to a working integration. Two of the three lessons need no account and no key of your own.
The key they use, sk_sandbox_public, is published on purpose. It is not a
demo that replays a canned answer. It runs the same recognition engine a paying
call runs, on the image you send it, and gives the fields back. It allows 10
requests per hour per client address, and a lifetime allowance of free
recognitions per client on top of that.
The three lessons¶
- Your first recognition — send one document, read every field that comes back, and see what the call took. No account.
- From the sandbox to a live key — spend the free allowance, register, and point the same code at a key that bills. An account, and no money: registration comes with 20 credits.
- Recognize a document without code — upload in the dashboard and read the result on screen. An account. No code at all.
Start with the first if you are integrating, and with the third if you are deciding whether to.
What a recognition costs¶
Nothing on either sandbox key. On a live key, one credit per billable scan, and one credit is one US cent. A scan is billable when the engine determined the document type and read something from it. A refusal that happened before the engine ran is never charged. The rule, and the cases around it, are on what a billed scan is.