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(mengembalikancost_usd); - setiap organisasi / setiap label: analitik pentadbir dan log permintaan (
request_logs, lihat analytics.md).
Ke mana seterusnya
- docs/quickstart.md — tindanan tempatan
- docs/labels.md — atribusi perbelanjaan
- docs/agent-governance.md — kunci ejen dan bajet
- docs/cli.md — rujukan arahan
yb