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.
https://lintastoken.ai.id/v1
—
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
pada SDK OpenAI ke server edge Lintas Token dan masukkan
Universal Secret Key
Anda.
baseURL
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.
Ganti Base URL
Arahkan SDK OpenAI Anda ke endpoint
dengan satu API Key utama.
https://lintastoken.ai.id/v1
Pilih Model Slug
Kirim request ke Claude 3.7, DeepSeek R1, GPT-4o, atau Gemini 2.5 cukup dengan mengganti string parameter
.
model
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
Contoh nyata menggunakan Claude 3.7 Sonnet (Thinking):
Jika aplikasi Anda mengirim prompt
dan menerima jawaban
800 token input
, maka saldo dompet Anda hanya terpotong sekitar
Rp 114
. Tidak ada pembulatan minimum bulanan atau biaya admin tersembunyi.
400 token output
Standar Header Autentikasi & Variabel Lingkungan (.env)
Semua permintaan ke endpoint Lintas Token wajib menyertakan header HTTP
. Jangan pernah menaruh Secret Key secara terbuka pada kode frontend browser (React/Vue client-side); selalu panggil melalui backend server atau simpan di file
Authorization: Bearer <API_KEY>
.
.env
LINTAS_API_KEY="sk-lintas-…" LINTAS_BASE_URL="https://lintastoken.ai.id/v1" LINTAS_CLIENT_ID="CL-1001"
Authorization: Bearer sk-lintas-… Content-Type: application/json X-Lintas-Client-ID: CL-1001 X-Lintas-Idempotency-Key: req-uuid-opsional
Generator Kode SDK Multi-Bahasa
// 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();
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:
-
Buka
Cursor Settings
(
) lalu pilih menu Models .Ctrl/Cmd + Shift + J -
Gulir ke bagian
OpenAI API Key
dan masukkan key Anda:
sk-lintas-… -
Klik
Override OpenAI Base URL
dan isi dengan:
https://lintastoken.ai.id/v1 -
Tambahkan nama model custom seperti
atauanthropic/claude-3.7-sonnet, lalu klik Verify .deepseek/deepseek-r1
- Buka ekstensi Cline atau Roo Code di VS Code dan klik ikon roda gigi (Settings).
- Pada API Provider , pilih OpenAI Compatible .
-
Isi
Base URL
dengan
dan tempelkan API Key Lintas Token Anda.https://lintastoken.ai.id/v1 -
Isi kolom
Model ID
dengan slug dari katalog, misalnya
untuk coding super hemat (~Rp 9/request).qwen/qwen-2.5-coder-32b-instruct
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:
https://lintastoken.ai.id/v1/chat/completions
Mengeksekusi prompt ke agent pilihan dan otomatis memotong saldo Rupiah sesuai bobot token input & output.
{
"model": "claude-3-7-sonnet-latest",
"messages": [
{ "role": "user", "content": "Cek koneksi gateway Jakarta" }
],
"max_tokens": 512,
"temperature": 0.2
}
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
{
"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
}
}
Tabel Parameter Model & Tarif Potong Saldo Real-Time
Tabel di bawah ini tersinkronisasi langsung dengan konfigurasi harga sistem saat ini. Klik pada
untuk menyalin string parameter model ke kode Anda:
modelSlug
| Nama Agent & Provider | Parameter modelSlug (Klik Salin) | Input / 1M | Output / 1M | Cache Read | Context & RPM |
|---|---|---|---|---|---|
| Deepseek V4 1 Flash tokenportal | Rp 896 | Rp 2.688 | — | 1.05M token — req/mnt | |
| Alicn Deepseek V4.1 Flash devup1 | Rp 896 | Rp 2.688 | — | 1.05M token — req/mnt |
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_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://lintastoken.ai.id/topup/CL-1001"
}
}
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
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
, dan
tool_choice
diteruskan secara transparan ke agent tujuan.
response_format: { type: "json_object" }