# API documentation

> How to get hCaptcha tokens and answers from the Ninetile API.

Canonical: https://ninetile.io/docs

## Getting started

The API uses JSON over HTTPS at https://api.ninetile.io/v1. Authenticate with `Authorization: Bearer nt_live_…`. Accounts use prepaid USD, and successful work is charged. Create an account, add balance, and create an API key.

## Pricing

- Token: $0.75 per 1,000 successful solves.
- Recognition: $0.30 per 1,000 successful answers.
- Failed, cancelled or expired solves and refused recognitions are free.

## API reference

- Token API: `POST /v1/solves` with a type, sitekey and URL. Add rqdata and a proxy if needed.
- Recognition API: `POST /v1/recognize` with the challenge and prompt.
- Read the [complete API documentation](https://ninetile.io/docs) for request fields, examples, response types, errors, limits, and compatibility.

## Chrome extension

The Chrome extension is coming soon.

## Detailed guides

- [Getting started](https://ninetile.io/docs/getting-started) - Configure an API key and make your first request.
- [Token API](https://ninetile.io/docs/token-api) - Create, poll, cancel and report outcomes for token solves.
- [Recognition API](https://ninetile.io/docs/recognition-api) - Request image challenge answers, including grid, area and drag task formats.
- [Billing and API key security](https://ninetile.io/docs/billing-and-security) - Understand balances, successful-request pricing and key restrictions.
- [Errors and limits](https://ninetile.io/docs/errors-and-limits) - Interpret API errors, retries, rate limits and task failures.
- [Compatibility APIs](https://ninetile.io/docs/compatibility) - Use supported compatibility endpoints and understand their scope.
- [Complete guide for AI agents](https://ninetile.io/docs/agent-guide)