DocumentationDokumentasi

Quick startMulai cepat

This API follows the OpenAI standard, so the libraries and apps you already use will work — you only change the base URL. API ini mengikuti standar OpenAI, jadi pustaka dan aplikasi yang sudah kamu pakai bisa langsung dipakai — cukup ganti alamat dasarnya.

What is a tokenApa itu token

A token is the smallest unit of text the model recognises — it can be a word, a number, or even a punctuation mark. Tokens are what you are billed for, not the number of messages or characters. Token adalah satuan terkecil teks yang dikenali model — bisa satu kata, satu angka, bahkan satu tanda baca. Token inilah yang dihitung sebagai biaya, bukan jumlah pesan atau jumlah huruf.

In other words, one long message does not cost the same as one short message. What counts is input tokens (your message) and output tokens (the model's reply). Artinya: mengirim satu pesan panjang tidak sama biayanya dengan satu pesan pendek. Yang dihitung adalah token masuk (pesanmu) dan token keluar (balasan model).

Rough character-to-token ratiosPerkiraan kasar karakter ke token

Official figures from the model provider, for Latin-script text: Angka resmi dari penyedia model, untuk teks berhuruf Latin:

• 1 Latin character ≈ 0.3 token — so 1 token ≈ 3–4 characters 1 karakter Latin ≈ 0,3 token — jadi 1 token ≈ 3–4 karakter
• One English word averages ≈ 1.3 tokens Satu kata bahasa Inggris rata-rata ≈ 1,3 token
• Code is denser: ≈ 8–12 tokens per realistic line Kode program lebih padat: ≈ 8–12 token per baris yang realistis

The big pictureGambaran besarnya

The figures above are for planning only. The amount billed is always the real number. Perkiraan di atas hanya untuk mengira-ngira. Angka yang ditagih selalu angka sebenarnya.

How to know exactly: read usageCara tahu pasti: baca usage

Every response includes the actual token counts. This is the authoritative source, not an estimate: Setiap balasan menyertakan jumlah token sebenarnya. Ini sumber yang benar, bukan perkiraan:

{
  "choices": [ ... ],
  "usage": {
    "prompt_tokens": 52,        // your message
    "completion_tokens": 118,   // the reply
    "total_tokens": 170,
    "prompt_cache_hit_tokens": 32,
    "prompt_cache_miss_tokens": 20
  },
  "x_ksr": {                    // added by us
    "dipotong_idr": 2.14,       // what was actually deducted
    "saldo_idr": 19997.86
  }
}

The x_ksr field answers the most common question: “how much did this call cost?” — without you having to work it out. Field x_ksr menjawab pertanyaan yang paling sering muncul: “berapakah biaya panggilan ini?” — tanpa perlu menghitung sendiri.

Thinking mode is on by default — and you pay for itMode berpikir menyala secara bawaan — dan kamu membayarnya

This is the single most expensive surprise on this API. The model reasons before answering by default, and every reasoning token is billed as an output token — taken from the same max_tokens budget as your answer. Ini kejutan paling mahal di API ini. Model berpikir dulu sebelum menjawab secara bawaan, dan setiap token penalaran ditagih sebagai token keluaran — diambil dari jatah max_tokens yang sama dengan jawabanmu.

Measured result: with max_tokens: 60 and thinking left on, a simple request returns empty content with finish_reason: "length" — all 60 tokens went to reasoning. The same request with thinking off answers in 3 tokens. Hasil pengukuran: dengan max_tokens: 60 dan berpikir dibiarkan menyala, permintaan sederhana mengembalikan content kosong dengan finish_reason: "length" — 60 token habis dipakai penalaran. Permintaan yang sama dengan berpikir dimatikan menjawab dalam 3 token.

To turn it off, add one field to your request: Untuk mematikannya, tambahkan satu field ke permintaanmu:

{
  "model": "deepseek-flash",
  "messages": [{"role": "user", "content": "Hello"}],
  "max_tokens": 60,
  "thinking": {"type": "disabled"}
}

How to spot it: content empty or short while completion_tokens_details.reasoning_tokens is large. Reasoning tokens are counted inside completion_tokens, so the amount billed is correct — it is the result and your budget that suffer. Cara mengenalinya: content kosong atau pendek padahal completion_tokens_details.reasoning_tokens besar. Token penalaran termasuk di dalam completion_tokens, jadi jumlah yang ditagih sudah benar — yang dirugikan adalah hasil dan anggaranmu.

Models & specificationsModel & spesifikasi

This list is read live from our system, so it always reflects the models currently available. Daftar ini dibaca langsung dari sistem kami, jadi selalu mengikuti model yang tersedia.

Context is the total conversation length the model can still remember (your messages plus its replies). Max output is the longest single reply it can produce. Konteks = panjang total percakapan yang masih bisa diingat model (pesanmu + balasannya). Keluaran maks = panjang balasan terpanjang yang bisa dihasilkan sekali jalan.

PricingHarga

Rupiah per 1 million tokens. Two things make prices differ: Satuan rupiah per 1 juta token. Ada dua hal yang membuat harga berbeda-beda:

• Input or output — output tokens are always more expensive than input. Masuk atau keluar — token keluaran selalu lebih mahal daripada masukan.
• Peak hours — at certain hours the rate is double. Jam sibuk — di jam tertentu tarifnya dua kali lipat.

A breakdown of the cost of a typical reply is on the main page. Rincian biaya satu balasan biasa juga bisa dilihat di halaman utama.

EndpointsEndpoint

Code examplesContoh kode

curl https://zenicat.net/ai/v1/chat/completions -H "Authorization: Bearer sk-ksr-YOURKEY" -H "Content-Type: application/json" -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Hello!"}]}'

from openai import OpenAI

client = OpenAI(
    base_url="https://zenicat.net/ai/v1",
    api_key="sk-ksr-YOURKEY",
)

r = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(r.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://zenicat.net/ai/v1",
  apiKey: "sk-ksr-YOURKEY",
});

const r = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(r.choices[0].message.content);

$data = json_encode([
  "model" => "deepseek-flash",
  "messages" => [["role" => "user", "content" => "Hello!"]],
]);

$ch = curl_init("https://zenicat.net/ai/v1/chat/completions");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer sk-ksr-YOURKEY",
  "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$out = json_decode(curl_exec($ch), true);
echo $out["choices"][0]["message"]["content"];

history = [{"role": "system", "content": "You are a friendly assistant."}]

def ask(message):
    history.append({"role": "user", "content": message})
    r = client.chat.completions.create(
        model="deepseek-flash",
        messages=history,
    )
    answer = r.choices[0].message.content
    history.append({"role": "assistant", "content": answer})
    return answer

Note that the whole history is sent every time, so input tokens grow as the conversation gets longer. To save money, trim the history or put fixed instructions in system so they hit the cache. Perhatikan: seluruh riwayat ikut dikirim setiap kali, jadi token masuknya bertambah seiring percakapan memanjang. Untuk menghemat, pangkas riwayat atau letakkan instruksi tetap di system agar kena cache.

Streaming

For replies that appear word by word, as in a chat app, send "stream": true. The reply arrives as data: chunks and ends with data: [DONE]. Untuk balasan yang muncul kata demi kata seperti di aplikasi chat, kirim "stream": true. Balasan datang sebagai potongan data: dan diakhiri data: [DONE].

stream = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Tell me a short story about coffee."}],
    stream=True,
)

for chunk in stream:
    piece = chunk.choices[0].delta.content
    if piece:
        print(piece, end="", flush=True)

Connecting to appsMenyambung ke aplikasi

Almost every AI app has a Base URL or API Base field. Enter https://zenicat.net/ai/v1 and paste your key. Hampir semua aplikasi AI punya kolom Base URL atau API Base. Isi dengan https://zenicat.net/ai/v1 lalu tempel kuncimu.

Limits & quotasBatas & kuota

If you need different limits, contact us — they are set per key. Kalau butuh batas berbeda untuk kebutuhanmu, hubungi kami — batas ini diatur per kunci.

Error codesArti kode error

All errors are returned as the same JSON shape, with a readable description: Semua error dikirim dalam bentuk JSON yang sama, dengan keterangan yang bisa dibaca:

{"error": {"message": "saldo habis. Silakan isi ulang untuk melanjutkan.",
          "type": "invalid_request_error", "code": 402}}

Balance & usageSaldo & pemakaian

Check any time: Cek kapan saja:

curl https://zenicat.net/ai/v1/balance -H "Authorization: Bearer sk-ksr-YOURKEY"

# {"saldo_idr": 19997.86, "batas_harian": 500}

curl https://zenicat.net/ai/v1/usage -H "Authorization: Bearer sk-ksr-YOURKEY"

The /v1/usage response contains the number of requests, input tokens, output tokens, total tokens, and the total billed over the last 30 days. Balasan /v1/usage berisi jumlah permintaan, token masuk, token keluar, total token, dan total yang sudah ditagih dalam 30 hari terakhir.

Credit never expires. There is no subscription and no expiry date — credit is used until it runs out, and you only pay for what you actually use. Saldo tidak hangus. Tidak ada langganan dan tidak ada masa aktif — saldo terpakai sampai habis, dan kamu hanya membayar apa yang benar-benar dipakai.

FAQTanya jawab

Is it exactly the same as the OpenAI API?Apakah sama persis dengan API OpenAI?

The request and response shapes are the same, so the OpenAI libraries work as-is. The differences are the model list and the extra x_ksr field in responses. Bentuk permintaan dan balasannya sama, jadi pustaka OpenAI bisa langsung dipakai. Yang berbeda hanya daftar model dan tambahan x_ksr pada balasan.

Why are the model names different from what I know?Kenapa nama modelnya berbeda dari yang saya kenal?

We follow the official names from the model provider. Older aliases such as deepseek-chat are still accepted so existing apps do not need changes. Kami mengikuti nama resmi dari penyedia model. Alias lama seperti deepseek-chat tetap kami terima supaya aplikasi yang sudah ada tidak perlu diubah.

Are my conversations stored?Apakah percakapan saya disimpan?

We store only the token counts and the cost, for billing. Not the content of your messages. The conversation content is processed by the model provider under their own policy. Kami hanya menyimpan jumlah token dan biaya untuk keperluan penagihan — bukan isi pesanmu. Isi percakapan diproses oleh penyedia model sesuai kebijakan mereka.

Can one key be used by several apps?Bisa dipakai untuk banyak aplikasi dengan satu kunci?

Yes. Usage is pooled into one balance, and you can request separate keys if you prefer separate reporting. Bisa. Pemakaiannya digabung ke satu saldo, dan kamu bisa minta kunci terpisah kalau ingin memisahkan pencatatannya.

What if I want to stop?Bagaimana kalau saya ingin berhenti?

There is no contract. Just stop using it; any remaining credit is still yours. Tidak ada ikatan. Tinggal berhenti memakai; saldo yang tersisa tetap milikmu.