Tokko API

Base URL

https://tokko-seven.vercel.app/api/v1

Authentication

All requests require a Bearer token in the Authorization header. Generate your token from the Settings page.

Authorization: Bearer tkk_your_token_here

POST /v1/compress

Compresses a prompt and returns the shorter version with token usage stats.

Request body

Response

A successful response returns the compressed text along with usage statistics.

{
  "compressed": "Python function: filter even numbers from list.",
  "usage": {
    "original_tokens": 64,
    "compressed_tokens": 18,
    "tokens_saved": 46,
    "reduction_pct": 72,
    "cost_saved_usd": 0.000138
  },
  "meta": {
    "mode": "balanced",
    "model": "claude",
    "id": "ps_1711234567_abc1234"
  }
}

Response fields

Rate limit headers

Errors

Errors return a consistent format with an error code you can handle programmatically.

{
  "error": {
    "message": "Daily limit reached (20/day on free plan)",
    "code": "rate_limit_exceeded",
    "status": 429
  }
}

Error codes

Examples

cURL

curl -X POST https://tokko-seven.vercel.app/api/v1/compress \
  -H "Authorization: Bearer tkk_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Could you please help me write a Python function that filters even numbers from a list?",
    "mode": "balanced"
  }'

Python

import requests

response = requests.post(
    "https://tokko-seven.vercel.app/api/v1/compress",
    headers={"Authorization": "Bearer tkk_your_token"},
    json={
        "prompt": "Could you please help me write a Python function that filters even numbers from a list?",
        "mode": "balanced"
    }
)

data = response.json()
print(data["compressed"])
# "Python function: filter even numbers from list."
print(f"Saved {data['usage']['reduction_pct']}% tokens")

JavaScript / Node.js

const response = await fetch("https://tokko-seven.vercel.app/api/v1/compress", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tkk_your_token",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    prompt: "Could you please help me write a Python function that filters even numbers from a list?",
    mode: "balanced",
  }),
});

const data = await response.json();
console.log(data.compressed);
// "Python function: filter even numbers from list."
console.log(`Saved ${data.usage.reduction_pct}% tokens`);

Use with OpenAI / Anthropic SDK

Compress your prompt before passing it to any AI SDK.

import Anthropic from "@anthropic-ai/sdk";

// 1. Compress the prompt first
const tokko = await fetch("https://tokko-seven.vercel.app/api/v1/compress", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tkk_your_token",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ prompt: userInput, mode: "smart" }),
});
const { compressed } = await tokko.json();

// 2. Send the compressed prompt to Claude
const anthropic = new Anthropic();
const message = await anthropic.messages.create({
  model: "claude-sonnet-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: compressed }],
});