Quickstart

Ninetile provides hCaptcha token solves and image recognition via JSON over HTTPS. Start by giving your coding agent the complete context below, or follow the quickstart yourself.

Copy the complete prompt for your AI agent

Click Copy and paste the complete prompt into your preferred coding agent. Replace the final request placeholder with your task. The prompt includes the Token and Recognition APIs, authentication, examples, billing, errors, limits, and compatibility routes.

Copy the complete Ninetile integration prompt for your AI agent

Create an account and API key

Sign in, add prepaid balance, and create an API key. The key is shown once. Keep it on your server and never put it in public code or logs.

Check your account

curl https://api.ninetile.io/v1/me \
  -H "Authorization: Bearer $NINETILE_API_KEY"

The response includes your balance, available balance, current limits, and pricing.

Create a token solve

Replace NINETILE_SITEKEY and the example URL with values for a system you are authorized to use.

curl 'https://api.ninetile.io/v1/solves?wait=60' \
  -H "Authorization: Bearer $NINETILE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "{\"type\":\"hcaptcha\",\"sitekey\":\"$NINETILE_SITEKEY\",\"url\":\"https://example.com/login\"}"

wait can be 1 to 90 seconds. If the request is still running, retrieve the same solve by ID. A successful token is short-lived and single-use. Use the returned user_agent when submitting it.

Creating a solve is a real request. A successfully solved token is charged against your prepaid balance.

Get Started

API Reference

Copy the complete prompt for your AI agent

Create an account and API key

Check your account

Create a token solve

​Copy the complete prompt for your AI agent

​Create an account and API key

​Check your account

​Create a token solve

Copy the complete prompt for your AI agent

Create an account and API key

Check your account

Create a token solve