npm SDK

npm install tokenc

import { TokenClient } from "tokenc";

const client = new TokenClient({ apiKey: "your-api-key" });

const response = await client.compressInput({
    input: "Your text that needs compression for optimal token usage.",
    aggressiveness: 0.1
});

console.log(`Compressed text: ${response.output}`);
console.log(`Original tokens: ${response.originalInputTokens}`);
console.log(`Compressed tokens: ${response.outputTokens}`);
console.log(`Tokens saved: ${response.tokensSaved}`);
console.log(`Compression ratio: ${response.compressionRatio.toFixed(2)}x`);

new TokenClient(options: TokenClientOptions)

// CompressResponse properties:
response.output                  // string: The compressed text
response.outputTokens            // number: Token count of compressed output
response.originalInputTokens     // number: Token count of original input
response.compressionTime         // number: Time taken to compress (seconds)

// Computed properties:
response.tokensSaved             // number: Number of tokens saved
response.compressionRatio        // number: Ratio of original to compressed tokens
response.compressionPercentage   // number: Percentage reduction in tokens

import { TokenClient } from "tokenc";
import OpenAI from "openai";

// Initialize clients
const tc = new TokenClient({ apiKey: "your-ttc-api-key" });
const openai = new OpenAI();

// Your prompt
const prompt = `Please explain the process of photosynthesis in detail,
including the light-dependent and light-independent reactions,
the role of chlorophyll, and how plants convert CO2 and water
into glucose and oxygen. Thank you very much for your help!`;

// Compress the prompt
const compressed = await tc.compressInput({
    input: prompt,
    aggressiveness: 0.6
});

console.log(`Compressed from ${compressed.originalInputTokens} to ${compressed.outputTokens} tokens`);
console.log(`Compression: ${compressed.compressionPercentage.toFixed(1)}%`);

// Use compressed prompt with OpenAI
const response = await openai.chat.completions.create({
    model: "gpt-4o",
    messages: [{ role: "user", content: compressed.output }]
});

console.log(response.choices[0].message.content);

import { TokenClient, CompressionSettings } from "tokenc";

const client = new TokenClient({ apiKey: "your-api-key" });

// Create custom compression settings
const settings = new CompressionSettings({
    aggressiveness: 0.7,
    maxOutputTokens: 100,
    minOutputTokens: 50
});

const response = await client.compressInput({
    input: "Your text here...",
    compressionSettings: settings
});

console.log(`Compression percentage: ${response.compressionPercentage.toFixed(1)}%`);

import { TokenClient } from "tokenc";

const client = new TokenClient({ apiKey: "your-api-key" });

const text = "Your long text here...";

// Light compression - preserve most content
const light = await client.compressInput({ input: text, aggressiveness: 0.2 });

// Moderate compression - balanced approach
const moderate = await client.compressInput({ input: text, aggressiveness: 0.5 });

// Aggressive compression - maximum savings
const aggressive = await client.compressInput({ input: text, aggressiveness: 0.8 });

import {
    TokenClient,
    AuthenticationError,
    InvalidRequestError,
    RateLimitError,
    APIError
} from "tokenc";

const client = new TokenClient({ apiKey: "your-api-key" });

try {
    const response = await client.compressInput({ input: "Your text..." });
} catch (error) {
    if (error instanceof AuthenticationError) {
        console.log("Invalid API key");
    } else if (error instanceof InvalidRequestError) {
        console.log(`Invalid request: ${error.message}`);
    } else if (error instanceof RateLimitError) {
        console.log("Rate limit exceeded, please wait");
    } else if (error instanceof APIError) {
        console.log(`API error: ${error.message}`);
    }
}