alwayscodex-api

Official Node.js & ES Module (ESM) SDK for AlwaysCodex REST API (https://api.alwayscodex.my.id).
Lightweight, zero-dependency, universal JavaScript client supporting AI models, downloaders, image tools, canvas generators, CORS proxy, binary media (image/audio/video) downloads, real-time SSE streaming (Agent API), file uploads, and AlightMotion Premium.

📦 Installation

npm install alwayscodex-api

🚀 Cara Import & Penggunaan

1. ES Modules (import)

import codex from "alwayscodex-api";

const api = codex({ apiKey: "YOUR_KEY" });

async function run() {
  const ai = await codex.ai.deepseek('Halo DeepSeek');
  console.log(ai);

  const gpt = await api.ai.gpt4({ text: 'Siapa penemu lampu?' });
  console.log(gpt);
}
run();

2. CommonJS (require)

const codex = require("alwayscodex-api");
const api = codex({ apiKey: "YOUR_KEY" });

async function run() {
  const ai = await codex.ai.deepseek('Halo dari CJS');
  console.log(ai);
}
run();

🔑 Tanpa API Key vs Dengan API Key

Tanpa API Key — Endpoint Gratis

const ai = await codex.ai.deepseek("Halo, siapa presiden pertama Indonesia?");
const tiktok = await codex.downloader.tiktok("https://vt.tiktok.com/xxxx");

Dengan API Key — Endpoint Premium

const api = codex({ apiKey: "YOUR_PREMIUM_KEY" });

const bulk = await api.am.bulk(1);
const hd = await api.imagehd.super_resolution("https://example.com/image.jpg");

🎨 5 Gaya Pemanggilan Fleksibel

| Gaya | Contoh | Hasil Path | |------|--------|-----------| | Dot notation | api.v4.chat.completions(...) | /api/v4/chat/completions | | CamelCase | api.v4.chatCompletions(...) | /api/v4/chat/completions | | snake_case | api.tools.password_generator(...) | /api/tools/password-generator | | kebab-case | api.tools["password-generator"](...) | /api/tools/password-generator | | Direct category | codex.imagehd(url) | default action |

const res1 = await codex.imagehd("https://example.com/img.jpg");
const res2 = await codex.maker.fakeNotif({ name: "Codex", message: "Hello!" });
const res3 = await codex.maker["fake-notif-wa"]({ name: "Codex", message: "Hello!" });

🧠 V4 Agent Gateway (OpenAI-compatible)

Support dot notation & camelCase:

const api = codex({ apiKey: "YOUR_KEY" });

// Daftar model
const models = await api.v4.models();
console.log(models.data);

// Chat completion
const chat = await api.v4.chat.completions({
  model: "auto",
  messages: [{ role: "user", content: "Halo" }],
  stream: false
});
console.log(chat.choices[0].message.content);

// Atau pake camelCase
const chat2 = await api.v4.chatCompletions({
  model: "auto",
  messages: [{ role: "user", content: "Halo" }]
});

⚡ AlightMotion Premium (AM)

const api = codex({ apiKey: "YOUR_KEY" });

// Kirim email verifikasi
await api.am.sendv2({ email: "[email protected]" });

// Verifikasi link
await api.am.verifyv2({ email: "[email protected]", link: "https://alight-creative..." });

// Bulk (max 100)
await api.am.bulk({ count: 5 });

📦 Handling Respons: JSON vs Image vs Video

SDK auto-detect Content-Type:

// JSON response
const ai = await codex.ai.gpt4("Apa ibukota Jepang?");
console.log(ai.result);

// Image response (Buffer)
const imgBuf = await codex.maker.fakeNotif({ name: "Bot", message: "Halo" });
fs.writeFileSync("output.jpg", imgBuf);

// Video response (Buffer)
const vidBuf = await codex.hdvidio["wink-hd-video"]({ url: "https://..." });
fs.writeFileSync("output.mp4", vidBuf);

⚡ Shortcut Methods

// GET
const getRes = await codex.get('/api/ai/gpt4', { teks: 'Halo' });

// POST
const postRes = await codex.post('/api/tools/password-generator', { length: 16 });

// Upload file
const uploadRes = await codex.upload('./gambar.png', { exp: 10, unit: 'menit' });

📝 Multiple Parameters

Semua parameter dikirim sebagai object — support jumlah parameter berapapun:

// 2 params
await api.am.verifyv2({ email: "[email protected]", link: "https://alight-creative..." });

// 3 params
await api.tools.spamOtp({ target: "0812xxx", jumlah: 5, delay: 1000 });

// Array + nested
await api.v4.chat.completions({
  model: "auto",
  messages: [{ role: "user", content: "Halo" }],
  temperature: 0.7,
  max_tokens: 2000,
  stream: false
});

// Parameter lewat string langsung (otomatis jadi parameter utama)
await api.ai.gemini("Halo");              // { teks: "Halo" }
await api.downloader.tiktok("https://..."); // { url: "https://..." }

⚙️ Opsi Inisialisasi

const api = codex({
  apiKey: "YOUR_KEY",           // API Key premium
  baseURL: "http://localhost:3000", // Custom base URL (default: https://api.alwayscodex.my.id)
  autoSync: false,              // Skip auto-sync endpoint
  timeout: 30000,               // Request timeout (ms)
});

⚠️ Catatan Error Handling

SDK tidak throw error untuk HTTP error response (4xx/5xx).
Response error dikembalikan dengan field _status dan _ok:

const res = await api.am.bulk({ count: 1 });
if (res._ok === false) {
  console.log(`Error ${res._status}: ${res.message}`);
}

📄 License

MIT © AlwaysCodex