Skip to main content

Bermula — Pengendali Yabanin (Kredit Prabayar)

Yabanin ialah kendalian sendiri: anda mengendalikan gerbang, panel pentadbir dan hubungan pengebilan dengan pengguna anda. Tiada pendaftaran yang dihoskan dan tiada senarai harga dalam repositori ini — harga penyedia dan sebarang margin jualan semula dikonfigurasikan dalam pangkalan data anda sendiri. Panduan ini membawa pengendali melalui persediaan prabayar yang berfungsi.

1. Laksanakan tindanan​

make docker-up # postgres + redis + migrations + gateway + admin
# or a single process:
yabanin dev --migrate

Panel pentadbir mendengar pada :8086 (hos compose :9091). Cipta akaun pentadbir anda dengan yabanin admin create-user (lihat --help; CLI menolak kata laluan sebaris — guna --password-stdin atau YABANIN_ADMIN_PASSWORD_FILE).

2. Konfigurasikan harga​

Harga model berada dalam jadual models_pricing dan itulah asas pengebilan gerbang. Muatkan harga itu daripada helaian harga penyedia anda:

yb pricing sync --apply # sync provider prices into models_pricing

Selepas penyegerakan, gerbang mengambil harga pangkalan data dalam masa 5 minit (cache DBPricer). Sama ada anda menjual semula dengan margin ialah keputusan komersial anda; Yabanin boleh mengira jumlah jualan semula daripada margin yang dikonfigurasikan, tetapi kadar itu ditetapkan dalam pelaksanaan anda, bukan diterbitkan di sini.

3. Cipta organisasi dan kunci API​

Dalam panel pentadbir: cipta organisasi pelanggan, kemudian terbitkan kunci API untuknya (api_keys). Kunci terhad kepada organisasi; perbelanjaan diatribusikan melalui label dan kunci sesi.

4. Tambah nilai kredit prabayar​

Yabanin mengebil secara prabayar: permintaan hanya dilayan semasa organisasi memegang kredit.

# Admin API (admin session auth; cross-org views are root-only):
POST /api/orgs/{org_id}/credits/topup # add credits
GET /api/orgs/{org_id}/credits/balance # current balance
GET /api/orgs/{org_id}/credits/transactions # ledger

Apabila baki habis, gerbang menolak permintaan inferens dengan 402 Payment Required (insufficient_credits) sehingga tambah nilai seterusnya. GET /api/credits/low-balance menyenaraikan organisasi yang menghampiri sifar. Cara anda mengutip bayaran (invois, Stripe, pindahan bank) berada di luar skop Yabanin.

5. Permintaan pertama​

export YABANIN_API_KEY="<key you minted>"
export BASE_URL="http://localhost:8082/v1"

curl "$BASE_URL/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $YABANIN_API_KEY" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello, World!"}],
"max_tokens": 50
}'

Respons ialah format chat OpenAI yang standard (tambah SSE dengan "stream": true). Perbelanjaan direkod di sisi pelayan — gerbang tidak menambah medan kos pada respons chat. Untuk membaca perbelanjaan:

  • setiap sesi: GET /v1/yabanin/session-keys/{id}/usage (mengembalikan cost_usd);
  • setiap organisasi / setiap label: analitik pentadbir dan log permintaan (request_logs, lihat analytics.md).

Ke mana seterusnya​