TokenomixAI API

Endpoint TokenomixAI mengikuti format OpenAI. Kode dan tool yang sudah mendukung OpenAI bisa langsung dipakai dengan mengganti base URL dan API key.

Quickstart

Beli paket di halaman pricing. Setelah pembayaran dikonfirmasi, kamu menerima API key sk-tkx-… dan hashtag akun.
Set base URL ke https://api.tokenomixai.com/v1.
Kirim request seperti ke OpenAI.

curl https://api.tokenomixai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.1",
    "stream": true,
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Autentikasi

Kirim key di header Authorization: Bearer sk-tkx-…. Key hanya ditampilkan sekali saat diterbitkan. TokenomixAI menyimpan key dalam bentuk hash, jadi key yang hilang tidak bisa ditampilkan ulang, hanya bisa di-rotate.

Endpoint

Method	Path	Keterangan
`GET`	`/v1/models`	Daftar model aktif
`POST`	`/v1/chat/completions`	Chat completion, mendukung `stream: true` (SSE)

Endpoint lain di luar daftar ini mengembalikan 404.

Setup tool

Cursor

Buka Settings → Models.
Isi OpenAI API Key dengan key sk-tkx-…, aktifkan Override OpenAI Base URL dan isi https://api.tokenomixai.com/v1.
Tambahkan nama model dari katalog (misalnya glm-5.1) sebagai custom model.

Cline / Roo Code

Pilih API Provider OpenAI Compatible, isi Base URL https://api.tokenomixai.com/v1, API Key, dan Model ID dari katalog.

Zed

// ~/.config/zed/settings.json
{
  "language_models": {
    "openai": {
      "api_url": "https://api.tokenomixai.com/v1",
      "available_models": [
        // max_tokens: sesuaikan dengan konteks model
        { "name": "glm-5.1", "display_name": "GLM 5.1 (TokenomixAI)", "max_tokens": 128000 }
      ]
    }
  }
}
// API key diisi lewat Agent Panel → Settings → OpenAI.

OpenCode

// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenomixai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenomixAI",
      "options": {
        "baseURL": "https://api.tokenomixai.com/v1",
        "apiKey": "{env:TOKENOMIXAI_API_KEY}"
      },
      "models": {
        "glm-5.1": { "name": "GLM 5.1" },
        "kimi-k3": { "name": "Kimi K3" }
      }
    }
  }
}

Lalu set TOKENOMIXAI_API_KEY di environment kamu.

9router

Buka Providers, lalu Add OpenAI Compatible.
Isi Prefix dengan txai (bebas, dipakai sebagai awalan ID model) dan API Type dengan Chat Completions.
Isi Base URL dengan https://api.tokenomixai.com/v1 dan API Key dengan sk-tkx-….
Isi Model ID dengan model dari katalog (misalnya glm-5.3-flash), klik Check sampai muncul Valid, lalu Create.

Model dipanggil dengan ID txai/<model-id>, dan bisa dimasukkan ke combo atau routing 9router seperti provider lain.

Hermes

Hermes bisa langsung ke TokenomixAI sebagai provider custom, tanpa perantara.

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.tokenomixai.com/v1
  default: auto        # atau model ID lain dari katalog
  key_env: ROUTER_API_KEY

# ~/.hermes/.env
ROUTER_API_KEY=sk-tkx-…

Nama variabel di key_env bebas, asal sama dengan yang kamu isi di .env. Kalau kamu sudah memakai 9router, Hermes juga bisa diarahkan ke 9router yang punya provider TokenomixAI di atas.

OpenClaw & agent lain

Pilih provider custom / OpenAI-compatible (API chat/completions), isi Base URL https://api.tokenomixai.com/v1, API Key sk-tkx-…, dan Model ID dari katalog. Agent memakai tool calling, jadi pilih model yang mendukungnya.

Model & multiplier

Daftar model dan multiplier selalu terbaru di katalog model. Token yang terpotong dihitung dengan:

token_terpakai = (prompt_tokens + completion_tokens) × multiplier

Contoh: model dengan multiplier 2× memotong 2.000 token untuk task 1.000 token.

Rate limit

Rate limit berlaku per API key dengan algoritma token bucket. Saat batas terlampaui, gateway mengembalikan 429 dengan header Retry-After (detik). Butuh batas lebih tinggi? Hubungi kami.

Kode error

Error mengikuti format OpenAI: {"error": {"message", "type", "code"}}.

HTTP	code	Arti
`401`	`invalid_api_key`	Key salah, sudah di-rotate, atau tidak dikirim.
`403`	`key_disabled`	Key dinonaktifkan. Hubungi support.
`404`	`not_found`	Endpoint tidak didukung gateway.
`404`	`model_not_available`	Model tidak tersedia di TokenomixAI. Cek ID di katalog model.
`429`	`rate_limit_exceeded`	Terlalu banyak request untuk key ini. Tunggu sesuai header Retry-After.
`502`	`upstream_unavailable`	Upstream tidak bisa dihubungi. Aman untuk di-retry.
`502`	`upstream_auth`	Masalah kredensial di sisi gateway. Hubungi support.

Portal & top-up

Masuk ke Portal dengan API key untuk melihat sisa kuota, masa aktif, riwayat request, dan rotate key. Untuk menambah kuota, beli paket dengan pilihan Top-up dan isi hashtag akun kamu (format #TKX-XXXXXX). Key tidak berubah saat top-up.

Data yang dicatat

Untuk setiap request, gateway mencatat: waktu, endpoint, model, status HTTP, latensi, dan jumlah token prompt/completion. Isi prompt dan jawaban tidak disimpan oleh gateway TokenomixAI. Request tetap diproses oleh penyedia model upstream untuk menghasilkan jawaban. Detail di Kebijakan Privasi.