Mga Seksyon ng Base ng Kaalaman ▾

Mga Kasangkapan

Management Keys — SaaS sa Gonka

Ikaw ba ay isang SaaS developer at nais mong mag-alok ng AI inference sa iyong mga kliyente nang walang sariling imprastraktura? Pinapayagan ng Management Keys ang paglikha ng hierarchical API keys: isang master-key ang namamahala sa maraming client-keys na may indibidwal na mga limitasyon at panahon ng bisa. Sa loob — JoinGonka Gateway at Gonka network.

Ano ang Management Keys

Ang Management Keys ay isang sistema ng hierarchical API keys para sa pagbuo ng mga produkto ng SaaS sa ibabaw ng Gonka AI Gateway.

Ang arkitektura ay dalawang-antas:

  • Management key (gm-) — ang iyong master key. Hindi ginagamit para sa inference nang direkta — para lamang sa paglikha at pamamahala ng mga child key.
  • Child key (gc-) — key para sa iyong kliyente. Ginagamit para sa inference requests. Ang billing ay ibinabawas mula sa balanse ng may-ari ng management key.

Ito ay isang white-label model: ang iyong mga kliyente ay gumagamit ng kanilang mga gc- keys at hindi alam ang tungkol sa Gonka — para sa kanila, ito ang iyong serbisyo.

Bakit Ito Kailangan

Kung walang Management Keys, ibibigay mo ang isang API key sa lahat ng kliyente — nang walang kontrol sa gastos, walang paghihiwalay, walang analytics. Sinasagot ng Management Keys ang 4 na gawain:

GawainPaano Sinasagot
Pagkontrol sa GastosAraw-araw at buwanang limitasyon sa GNK para sa bawat child key
Panandaliang Pag-accessTTL (expires_at) — awtomatikong de-activate ang key
Paghihiwalay ng KliyenteBawat kliyente ay may sariling gc- key at rate limit
Pinag-isang BillingLahat ng child keys ay ibabawas mula sa iyong balanse — isang bill

Paano Gumawa ng Management Key

Hakbang 1: Magrehistro sa gate.joingonka.ai at dagdagan ang balanse ng GNK o USDT.

Hakbang 2: Gumawa ng management key sa pamamagitan ng API:

curl -X POST https://gate.joingonka.ai/api/management/keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "My SaaS"}'

Naglalaman ang tugon ng plain key (prefix gm-) — i-save ito, isang beses lang ito ipinapakita.

Hakbang 3: Gumawa ng child key para sa kliyente:

curl -X POST https://gate.joingonka.ai/api/management/keys/{gm_key_id}/children \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Client A", "limit_daily_ngonka": "1000000000", "rate_limit_rpm": 30}'

Nakukuha ng Kliyente A ang gc- key na may limitasyon na 1 GNK/araw at 30 kahilingan/minuto.

Mga Limitasyon at TTL

Bawat child key ay sumusuporta sa tatlong uri ng limitasyon:

  • Daily limit (limit_daily_ngonka) — maximum na gastos sa bawat UTC-araw. Awtomatikong nagre-reset sa hatinggabi UTC.
  • Monthly limit (limit_monthly_ngonka) — maximum sa bawat kalendaryong buwan.
  • TTL (expires_at) — petsa/oras ng pag-expire ng key. Pagkatapos nito, hihinto ang key sa pagiging authenticated.

Kung lalampas sa daily o monthly limit, makakatanggap ang kliyente ng HTTP 402 na may mga detalye:

{"error": {"type": "child_key_limit", "daily_remaining": "0", "monthly_remaining": "500000000"}}

Lahat ng limitasyon ay opsyonal — kung hindi tinukoy, ang key ay limitado lamang sa balanse ng may-ari.

Pamamahala ng mga child keys

Buong CRUD sa pamamagitan ng API:

OperasyonEndpointDeskripsyon
GumawaPOST /api/management/keys/:id/childrenBagong gc- key na may mga limitasyon
ListahanGET /api/management/keys/:id/childrenLahat ng child keys na may usage
I-updatePATCH /api/management/keys/:id/children/:childIdBaguhin ang mga limitasyon, RPM, status
BurahinDELETE /api/management/keys/:id/children/:childIdSoft-deactivation

Maaari ding pamahalaan sa pamamagitan ng Dashboard: seksyon ng API Keys → Management Keys.

Paghahambing sa mga Kakumpitensya

AbilidadJoinGonkaGonkaGateOpenRouter
Management keysgm- / gc-gpm- (Marso 2026)Wala
Mga limitasyon araw-araw/buwananGNK (nGNK)USD
TTL (panahon ng bisa)expires_atWala
Dashboard UIOo (seksyon ng Keys)Wala
Mga Referral10% L1 + 3% L2WalaWala
Presyo ng inference$0.001/1M~$0.0035/1M$0.08+/1M

Ang JoinGonka — ang tanging Gonka gateway na may GNK limits, TTL at Dashboard UI para sa management keys.

Ang Management Keys ay ginagawang white-label platform ang JoinGonka Gateway. Isang management key → walang limitasyong bilang ng child keys na may indibidwal na limitasyon. Ang iyong mga kliyente ay nakakakuha ng AI inference, kontrolado mo ang mga gastusin at kumikita ka sa margin.

Gusto mo pang matuto?

Galugarin ang iba pang mga seksyon o simulang kumita ng GNK ngayon.

Kumuha ng libreng 10M token →