CTH
Developer Resources

API Documentation

Power your applications with the CipherToolsHub API. Simple, secure, and production-ready endpoints for developers.

Authentication

Secure your requests with API keys

All API requests require authentication using an API Key. You can obtain your API key from the Developer Dashboard.

Header Authentication

Include your API key in the X-API-Key header of your request.

X-API-Key: your_api_key_here

API Base URL

https://api.ciphertoolshub.com/api/v1

Rate Limits & Costs

Understanding credits and plan limits

Cost Per Call

Each successful API call consumes 1 Credit by default. Some specialized premium tools may have different credit costs which will be clearly indicated in the response metadata.

Batch Limit Reminder

Parallel requests are permitted up to your plan's hourly rate limit. High-tier plans support higher concurrency for heavy workloads.

Plan Comparison

PlanRate LimitMonthly Credits
Free
$0 / mo
60 requests/hour
100 Free10 Premium
Premium Lite
$2 / mo
200 requests/hour
2,000 Free250 Premium
Premium Standard
$4 / mo
400 requests/hour
5,000 Free1,000 Premium
Premium Pro
$8 / mo
600 requests/hour
10,000 Free5,000 Premium
Premium Yearly
$79 / mo
600 requests/hour
0 Free0 Premium
Team Starter
$15 / mo
1,200 requests/hour
20,000 Free5,000 Premium
Team Yearly
$149 / mo
1,200 requests/hour
0 Free0 Premium

Endpoints

Interactive API documentation for all available tools

v1.2.0
REST API

Image to Text OCR

POST

Extract text and tables from images using advanced AI OCR

POSThttps://api.ciphertoolshub.com/api/v1/image-to-text

Request Body

{
  "images": "[binary_files]"
}
application/json

Success Response

{
  "success": true,
  "results": [
    {
      "filename": "scan.jpg",
      "text": "Extracted text...",
      "structured_data": []
    }
  ],
  "api_calls": {
    "type": "free",
    "consumed": true
  }
}
Response Code
200 OK
Content-Type
application/json

Error Codes

Standardized HTTP response errors

400

Bad Request

Missing parameters or invalid input format.

401

Unauthorized

Invalid, expired, or missing API key.

402

Payment Required

Insufficient credits or upgrade required.

403

Forbidden

No permission to access this resource.

429

Too Many Requests

Global or user rate limit has been exceeded.

500

Server Error

Internal failure. Contact support if persistent.