ER-API SDK

A TypeScript/JavaScript SDK for the ER-API platform, providing easy access to AI models, media downloads, image generation, games, and other utilities.

Installation

npm install er-api-sdk   # npm
yarn add er-api-sdk      # yarn
pnpm add er-api-sdk      # pnpm

Quick Start

import { ErApiSdk } from 'er-api-sdk';
import * as dotenv from 'dotenv';

// Load environment variables
dotenv.config();

// Option 1: Initialize with environment variables
const sdk = ErApiSdk.fromEnv();

// Option 2: Set API keys directly
ErApiSdk.openRouter.setApiKey('YOUR_OPENROUTER_API_KEY');

async function main() {
  try {
    // Chat with AI models
    const aiResponse = await sdk.gpt4('What is the capital of France?');
    console.log('AI Response:', aiResponse);

    // Generate an image
    const imageBuffer = await ErApiSdk.brat('a colorful landscape');
    require('fs').writeFileSync('image.jpg', imageBuffer);

    // Download TikTok video
    const tiktok = await ErApiSdk.ttdl('https://www.tiktok.com/@user/video/12345');
    console.log('TikTok download:', tiktok);

    // Play a word game
    const wordGame = await ErApiSdk.tebakkata();
    console.log('Word Game:', wordGame);
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

Main Features

AI Services

// Initialize from environment variables (recommended)
const sdk = ErApiSdk.fromEnv();

// Use model aliases for convenience
const response = await sdk.gpt4('Your prompt here');
const claude = await sdk.claude3('Tell me a story');

// Direct model access with options
const customResponse = await sdk.chat('openai/gpt-4-turbo', 'Hello world', {
  temperature: 0.7,
  max_tokens: 500,
});

// Available model aliases:
// gpt4, gpt35, claude3, claude3s, claude3h, mistral, gemini,
// gemini2, llama3, mixtral, llamavision

Note: Direct access to individual AI providers (like ErApiSdk.deepseek(), ErApiSdk.openai(), etc.) has been deprecated in favor of the unified OpenRouter interface shown above.

Media Downloads

// Download videos/audio from various platforms
const tiktok = await ErApiSdk.ttdl('https://www.tiktok.com/@user/video/12345');
const spotify = await ErApiSdk.spotify('https://open.spotify.com/track/...');
const mp3 = await ErApiSdk.ermp3('https://youtube.com/watch?v=xxxx');
const mp4 = await ErApiSdk.ermp4('https://youtube.com/watch?v=xxxx');

Image Generation

// Generate images from text descriptions
const imageBuffer = await ErApiSdk.brat('anime girl with blue hair');
const text2imgBuffer = await ErApiSdk.text2img('Your text here');

Games & Entertainment

// Indonesian word games
const wordGame = await ErApiSdk.tebakkata();
const familyGame = await ErApiSdk.family100();
const truthGame = await ErApiSdk.truth();
const dareGame = await ErApiSdk.dare();

// Many more games available - see documentation

Custom Endpoints

// Register and use custom endpoints
ErApiSdk.registerCustomEndpoint('weather', '/api/weather');
const weather = await ErApiSdk.custom.weather({ city: 'Jakarta' });

Configuration

Using Environment Variables

The SDK can load all API keys from environment variables with the fromEnv() method:

// Create an SDK instance with environment variables
const sdk = ErApiSdk.fromEnv();

// This loads the following environment variables:
// - OPENROUTER_API_KEY: For OpenRouter access (required for custom params)
// - ERAPI_BASE_URL: Optional custom API base URL
// - ERAPI_CUSTOM_ENDPOINT_*: For custom endpoints (optional)

This approach is recommended for production use as it keeps your API keys secure and separate from your code.

Using .env File

# AI API Keys
OPENROUTER_API_KEY=your_openrouter_key

# Custom endpoints (optional)
ERAPI_CUSTOM_ENDPOINT_WEATHER=/api/weather

# Base URL (optional)
ERAPI_BASE_URL=https://er-api.biz.id

Manual Configuration

// Set API key
ErApiSdk.openRouter.setApiKey('YOUR_API_KEY');

// Change base URL
ErApiSdk.setBaseUrl('https://your-custom-api.example.com');

Error Handling

try {
  const response = await ErApiSdk.gpt4('Hello world');
  console.log(response);
} catch (error) {
  if (error.name === 'MissingApiKeyError') {
    console.error('API key not provided');
  } else {
    console.error('Error:', error.message);
  }
}

Documentation

For detailed API documentation, visit our TypeDoc Documentation.

License

This project is licensed under the Unlicense - see the LICENSE file for details.