API Documentation - KOL.Tools Developer Portal

API Overview

The KOL.Tools API allows you to integrate our content creation tools directly into your applications. Our RESTful API provides access to all our core features including text overlay, background removal, image resizing, and more.

Base URL

https://api.kol.tools/v1

Authentication

Authorization: Bearer YOUR_API_KEY

Quick Start

Sign up for a KOL.Tools account
Generate your API key from the dashboard
Make your first API call using the examples below
Start building amazing content creation features!

API Endpoints

Add Text to Photo

Add custom text overlay to images with various fonts and styling options.

POST /text-overlay

curl -X POST https://api.kol.tools/v1/text-overlay \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "text": "Hello World",
    "font": "Arial",
    "font_size": 48,
    "color": "#ffffff",
    "position": {
      "x": 50,
      "y": 50
    }
  }'

Background Remover

Remove backgrounds from images using AI-powered technology.

POST /background-remover

curl -X POST https://api.kol.tools/v1/background-remover \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "output_format": "png"
  }'

Image Resizer

Resize images to specific dimensions while maintaining quality.

POST /resize

curl -X POST https://api.kol.tools/v1/resize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "width": 800,
    "height": 600,
    "maintain_aspect_ratio": true,
    "quality": 90
  }'

Response Formats

All API responses are returned in JSON format. Successful requests return HTTP 200 status codes with the response data in the body.

Success Response

{
  "success": true,
  "data": {
    "processed_image_url": "https://cdn.kol.tools/processed/image123.jpg",
    "thumbnail_url": "https://cdn.kol.tools/thumbs/image123.jpg",
    "processing_time": 2.5,
    "file_size": 1024000
  },
  "request_id": "req_123456789"
}

Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_IMAGE_FORMAT",
    "message": "Unsupported image format. Please use JPG, PNG, or WebP.",
    "details": "The provided image file is not supported."
  },
  "request_id": "req_123456789"
}

Rate Limits

Free Tier

100

requests per day

Pro Tier

10,000

requests per day

Enterprise

Unlimited

custom limits

SDKs & Libraries

JavaScript SDK

Official JavaScript library for browser and Node.js environments.

npm install @kol.tools/sdk

Python SDK

Python library for integrating KOL.Tools into your backend.

pip install koltools-sdk