Satu Saldo, Lintas Model AI.
DOKUMENTASI TEKNIS & REFERENSI API LENGKAP (v2.4)

Pusat Dokumentasi Developer Lintas Token

Panduan lengkap integrasi Universal API Key berdenominasi Rupiah. 100% kompatibel dengan SDK resmi OpenAI, mendukung pemotongan saldo presisi per token untuk 6+ Agent AI terdepan, pengaturan IDE coding, hingga webhook akuntansi.

Kredensial Akun Aktif Anda Saldo: —
BASE URL https://lintastoken.ai.id/v1
SECRET API KEY (—)) —
BAB 01 · ARSITEKTUR & QUICKSTART 60 DETIK

Cara Kerja Gateway Saldo Rupiah Lintas Token

Lintas Token bekerja sebagai Unified OpenAI-Compatible API Router dengan buku besar (ledger) berdenominasi Rupiah. Anda tidak perlu mengubah struktur kode aplikasi yang sudah ada—cukup arahkan parameter baseURL pada SDK OpenAI ke server edge Lintas Token dan masukkan Universal Secret Key Anda.

LANGKAH 1

Deposit Saldo IDR

Top-up mulai Rp 50.000 via QRIS / Virtual Account lokal tanpa kartu kredit USD dan masa aktif saldo tidak pernah hangus.

LANGKAH 2

Ganti Base URL

Arahkan SDK OpenAI Anda ke endpoint https://lintastoken.ai.id/v1 dengan satu API Key utama.

LANGKAH 3

Pilih Model Slug

Kirim request ke Claude 3.7, DeepSeek R1, GPT-4o, atau Gemini 2.5 cukup dengan mengganti string parameter model .

LANGKAH 4

Potong Presisi & Audit

Saldo terpotong sesuai jumlah token aktual. Setiap transaksi tercatat di buku besar dan dapat di-export ke CSV/PDF.

Rumus Presisi Pemotongan Saldo Rupiah Per Panggilan API

Potongan_IDR = ((Token_Input / 1.000.000) × Tarif_Input_Agent) + ((Token_Output / 1.000.000) × Tarif_Output_Agent)

Contoh nyata menggunakan Claude 3.7 Sonnet (Thinking): Jika aplikasi Anda mengirim prompt 800 token input dan menerima jawaban 400 token output , maka saldo dompet Anda hanya terpotong sekitar Rp 114 . Tidak ada pembulatan minimum bulanan atau biaya admin tersembunyi.

BAB 02 · AUTENTIKASI & KEAMANAN CREDENTIALS

Standar Header Autentikasi & Variabel Lingkungan (.env)

Semua permintaan ke endpoint Lintas Token wajib menyertakan header HTTP Authorization: Bearer <API_KEY> . Jangan pernah menaruh Secret Key secara terbuka pada kode frontend browser (React/Vue client-side); selalu panggil melalui backend server atau simpan di file .env .

1. File Konfigurasi .env
LINTAS_API_KEY="sk-lintas-…"
LINTAS_BASE_URL="https://lintastoken.ai.id/v1"
LINTAS_CLIENT_ID="CL-1001"
2. Header HTTP Request Standar
Authorization: Bearer sk-lintas-…
Content-Type: application/json
X-Lintas-Client-ID: CL-1001
X-Lintas-Idempotency-Key: req-uuid-opsional
Proteksi Penalti & Penangguhan Otomatis: Apabila Anda mendeteksi kebocoran API Key, Anda atau Administrator Organisasi dapat langsung membekukan status Key melalui Halaman Admin atau merotasi key baru tanpa kehilangan sisa saldo Rupiah di dalam dompet.
BAB 03 · CONTOH KODE INTEGRASI SIAP PAKAI

Generator Kode SDK Multi-Bahasa

Model aktif: claude-3-7-sonnet-latest · Estimasi: ~Rp 2/req
// 1. Install SDK resmi OpenAI: npm install openai
import OpenAI from 'openai';

const toka = new OpenAI({
  baseURL: 'https://lintastoken.ai.id/v1',
  apiKey: process.env.LINTAS_API_KEY || 'sk-lintas-…',
  defaultHeaders: {
    'X-Lintas-Client-ID': 'CL-1001', // Opsional: ID Organisasi untuk audit
  },
});

async function main() {
  const response = await toka.chat.completions.create({
    model: 'claude-3-7-sonnet-latest', // Claude 3.7 Sonnet (Thinking)
    stream: false,
    messages: [
      {
        role: 'system',
        content: 'Anda adalah arsitek sistem backend senior Indonesia.',
      },
      {
        role: 'user',
        content: 'Buatkan skema database PostgreSQL untuk sistem e-wallet QRIS.',
      },
    ],
    temperature: 0.2,
  });

  console.log(response.choices[0].message.content);
  // Header respons menyertakan X-Lintas-Cost-IDR & X-Lintas-Balance-Remaining-IDR
}

main();
BAB 04 · INTEGRASI AI CODING EDITOR

Cara Pasang Lintas Token di Cursor IDE, VS Code Cline, & Windsurf

Anda dapat menggunakan saldo Rupiah Lintas Token langsung di dalam editor koding favorit Anda tanpa berlangganan bulanan $20/bulan:

Cursor IDE Rekomendasi: claude-3-7-sonnet
  1. Buka Cursor Settings ( Ctrl/Cmd + Shift + J ) lalu pilih menu Models .
  2. Gulir ke bagian OpenAI API Key dan masukkan key Anda: sk-lintas-…
  3. Klik Override OpenAI Base URL dan isi dengan: https://lintastoken.ai.id/v1
  4. Tambahkan nama model custom seperti anthropic/claude-3.7-sonnet atau deepseek/deepseek-r1 , lalu klik Verify .
✓ Mendukung fitur Composer, Chat, & Apply Code Diff
VS Code (Cline / Roo Code / Continue) Rekomendasi: qwen-2.5-coder-32b
  1. Buka ekstensi Cline atau Roo Code di VS Code dan klik ikon roda gigi (Settings).
  2. Pada API Provider , pilih OpenAI Compatible .
  3. Isi Base URL dengan https://lintastoken.ai.id/v1 dan tempelkan API Key Lintas Token Anda.
  4. Isi kolom Model ID dengan slug dari katalog, misalnya qwen/qwen-2.5-coder-32b-instruct untuk coding super hemat (~Rp 9/request).
✓ Mendukung eksekusi terminal otomatis & pembacaan pohon file
BAB 05 · REFERENSI ENDPOINT REST API

Spesifikasi Endpoint & Inspector Respons JSON

Klik salah satu endpoint di bawah ini untuk melihat struktur payload Request, Header Respons Billing, dan objek JSON yang dikembalikan oleh server Lintas Token:

POST https://lintastoken.ai.id/v1/chat/completions

Mengeksekusi prompt ke agent pilihan dan otomatis memotong saldo Rupiah sesuai bobot token input & output.

Request Payload / Parameter
{
  "model": "claude-3-7-sonnet-latest",
  "messages": [
    { "role": "user", "content": "Cek koneksi gateway Jakarta" }
  ],
  "max_tokens": 512,
  "temperature": 0.2
}
Response HTTP Headers
HTTP/2 200 OK
content-type: application/json
x-toka-node-region: ap-southeast-3 (Jakarta-IIX)
x-toka-cost-idr: 114
x-toka-balance-remaining-idr: 324736
x-ratelimit-remaining-requests: 7999
Response Body (200 OK JSON)
{
  "id": "chatcmpl-toka-982341a",
  "object": "chat.completion",
  "created": 1759876200,
  "model": "claude-3-7-sonnet-latest",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Koneksi Gateway Lintas Token Node Jakarta (IIX) aktif dengan latensi 168 ms."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 800,
    "completion_tokens": 400,
    "total_tokens": 1200
  },
  "lintas_billing": {
    "currency": "IDR",
    "input_rate_per_1m_idr": 45000,
    "output_rate_per_1m_idr": 225000,
    "deducted_idr": 114,
    "balance_after_idr": 324736
  }
}
BAB 06 · DAFTAR MODEL SLUG, TARIF & KUOTA RATE LIMIT

Tabel Parameter Model & Tarif Potong Saldo Real-Time

Tabel di bawah ini tersinkronisasi langsung dengan konfigurasi harga sistem saat ini. Klik pada modelSlug untuk menyalin string parameter model ke kode Anda:

Nama Agent & Provider Parameter modelSlug (Klik Salin) Input / 1M Output / 1M Cache Read Context & RPM
Deepseek V4 1 Flash tokenportal Rp&nbsp;896 Rp&nbsp;2.688 — 1.05M token — req/mnt
Alicn Deepseek V4.1 Flash devup1 Rp&nbsp;896 Rp&nbsp;2.688 — 1.05M token — req/mnt
BAB 07 · WEBHOOK OTOMATIS & NOTIFIKASI LIMIT SALDO

Integrasi Webhook Saat Saldo di Bawah Limit Minimum

Selain peringatan visual merah di Halaman Client , Lintas Token dapat mengirimkan HTTP POST Webhook ke server Anda (atau ke bot grup Telegram/Slack/Discord tim DevOps Anda) tepat ketika saldo dompet turun melewati ambang batas minimum yang Anda atur:

Event: wallet.low_balance.alert
{
  "event_id": "evt_lowbal_99281",
  "event_type": "wallet.low_balance.alert",
  "timestamp": "2026-10-08T00:30:00+07:00",
  "client_id": "CL-1001",
  "company_name": "Nusantara Tech (Akun Anda)",
  "data": {
    "current_balance_idr": 185000,
    "configured_threshold_idr": 250000,
    "deficit_idr": 65000,
    "last_agent_used": "claude-3-7-sonnet-latest",
    "quick_topup_url": "https://www.lintastoken.ai.id/topup/CL-1001"
  }
}
Verifikasi Signature HMAC-SHA256 (Node.js)
import crypto from 'crypto';

export function verifyTokaWebhook(rawBody, signatureHeader, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  const digest = 'sha256=' + hmac.update(rawBody).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(digest),
    Buffer.from(signatureHeader)
  );
}
// Header: X-Lintas-Signature-256
BAB 08 · KODE STATUS HTTP, FAILOVER & FAQ TEKNIS

Penanganan Kode Status Error & Pertanyaan Umum

Kode HTTP Kode Error Internal Penyebab & Solusi Penanganan
401 Unauthorized missing_api_key Header Authorization: Bearer <API_KEY> tidak ditemukan.
401 Unauthorized invalid_api_key API key tidak valid. Periksa kembali Authorization header Anda.
401 Unauthorized api_key_revoked API key ini sudah dicabut atau kedaluwarsa.
401 Unauthorized account_inactive Akun Anda tidak aktif. Hubungi support.
401 Unauthorized ip_not_allowed Alamat IP Anda tidak diizinkan untuk API key ini.
402 Payment Required insufficient_balance Saldo Anda tidak cukup. Segera top up di menu Dashboard → Top Up, lalu ulangi permintaan.
429 Too Many Requests daily_limit_reached Limit harian API key ini sudah tercapai.
404 Not Found model_not_found Model tidak ditemukan pada katalog platform. Gunakan nama model lain yang tersedia di halaman daftar model.
404 Not Found model_not_priced Model ini belum memiliki harga jual. Hubungi administrator.
429 Too Many Requests rate_limited Terlalu banyak permintaan. Coba beberapa saat lagi.
422 Unprocessable Entity validation_error Payload request tidak valid.
504 Gateway Timeout upstream_timeout Provider AI tidak merespons tepat waktu. Coba lagi sebentar lagi, atau gunakan model lain.
503 Service Unavailable upstream_unavailable Provider untuk model ini sedang tidak tersedia. Coba lagi sebentar lagi, atau gunakan model lain.
502 Bad Gateway upstream_error Provider AI sedang bermasalah. Coba lagi sebentar lagi, atau gunakan model lain.
502 Bad Gateway empty_response Provider AI mengembalikan jawaban kosong. Coba lagi sebentar lagi, atau gunakan model lain.
500 Internal Server Error internal_error Terjadi kesalahan internal pada gateway.

Apakah saldo yang tidak terpakai akan hangus di akhir bulan?

Tidak pernah hangus. Berbeda dengan langganan bulanan $20/bulan, saldo deposit Rupiah Anda di Lintas Token berlaku selamanya tanpa tanggal kedaluwarsa.

Bagaimana jika panggilan API gagal (timeout/error 500)?

Saldo dijamin 100% utuh. Sistem ledger Lintas Token hanya memotong saldo apabila respons dari model AI berhasil dikirim dengan status HTTP 200 OK .

Apakah tersedia laporan untuk klaim reimbursement & pajak kantor?

Ya. Buka Halaman Client dan gulir ke bagian bawah untuk mengunduh laporan penggunaan saldo dalam format CSV (Excel) atau PDF Audit Resmi .

Bisakah saya menggunakan Function Calling (Tools) dan JSON Schema?

Bisa. Seluruh parameter standar OpenAI seperti tools , tool_choice , dan response_format: { type: "json_object" } diteruskan secara transparan ke agent tujuan.