Správca brány
Vytvára účty u poskytovateľov, ukladá ich kľúče v Poskytovatelia, nastavuje modely a schvaľuje rozpočty projektov. Potrebuje oprávnenie na správu príslušnej sekcie.
Od prvého API kľúča po fungujúci portál. Postupy pre správcu brány aj zákazníka, na jednom mieste.
Vytvára účty u poskytovateľov, ukladá ich kľúče v Poskytovatelia, nastavuje modely a schvaľuje rozpočty projektov. Potrebuje oprávnenie na správu príslušnej sekcie.
Používa projektový kľúč vytvorený v MEXCOR. Kľúče OpenAI ani iných poskytovateľov do zákazníckeho portálu nenahráva. Owner alebo developer vytvára kľúče svojho projektu; finance a viewer ich nevytvárajú.
Portál → projektový kľúč MEXCOR → brána → kľúč poskytovateľa → AI model
Nemusíte zakladať všetkých päť účtov. Začnite jedným poskytovateľom a modelom; ďalších pridajte pre požadované funkcie alebo záložné smerovanie.
Po pripojení poskytovateľov a modelov sa tu odohráva bežná prevádzka — od prvého projektu zákazníka po sledovanie nákladov a kvality.
Vytvorte projekt pre každého zákazníka alebo portál. Povoľte konkrétnych poskytovateľov/modely (prázdny zoznam povolení znamená žiadny, hodnota null znamená všetky) a nastavte kladný denný aj mesačný rozpočet — nový projekt je bez toho zablokovaný.
Zoraďte modely podľa priority pre danú úlohu (chat, embeddings, vision…). Brána ich skúša v poradí a pri zlyhaní automaticky prejde na ďalší, až tri pokusy, pokiaľ sa už nezačal streamovať výstup klientovi.
Pravidlá upozornení sledujú metriku (náklady, chybovosť, latenciu) v pohyblivom okne a spustia sa pri prekročení prahu. Webhook endpointy doručujú udalosti ako provider.down na vlastný server projektu.
Výsledky zobrazujú kvalitu a náklady podľa projektu, prostredia a úlohy s intervalom spoľahlivosti. Portfólio agreguje výdavky a úsporu z cache naprieč všetkými projektmi na jednej stránke.
gateway:downgrade-recommend porovná lacnejší kandidátsky model s dôkazmi z reálnej prevádzky (dokončenia, pokrytie hodnotením, miera prijatia). Ak model prejde, gateway:downgrade-canary naň nasmeruje malý, kontrolovaný podiel prevádzky pred schválením alebo vrátením.
Role siahajú od viewer po super_admin, každá s explicitným zoznamom povolených modulov. Každý admin účet si môže v Bezpečnosti pridať passkey (Face ID / Touch ID), popri hesle a 2FA — 2FA je v produkcii vynútené automaticky.
Šifrované zálohy bežia denne a ich obnova je otestovaná. Pred nasmerovaním reálnej prevádzky na nové prostredie spustite gateway:readiness --launch — spolu overí databázu, worker frontu, plánovač a nedávnu úspešnú zálohu.
Prehľad toho, čo tu ako zákazník môžete robiť — bežná správa účtu, nie technické napojenie na API (na to slúži sekcia Pripojenie vášho portálu a API návod nižšie).
Môj portál zobrazuje všetky organizácie, ktorých ste členom. Ak ich je viac, tu medzi nimi prepínate — každá má vlastné projekty, kľúče a fakturáciu.
Projekt zvyčajne zodpovedá jednej appke alebo webu. Owner alebo developer ho vytvorí zo stránky organizácie; každý projekt má vlastné API kľúče, spotrebu a prostredie (development, staging, production).
Vytvorte kľúč pre každé prostredie a pomenujte ho výstižne. Celý kľúč sa zobrazí iba raz, pri vytvorení — hneď ho uložte do správcu tajomstiev. Kľúč, ktorý už nepoužívate alebo podozrievate z úniku, zrušte; platí to okamžite.
Každý projekt zobrazuje priebežnú spotrebu za aktuálne obdobie. Na konci mesiaca sa vystaví nemenný spotrebný výkaz v EUR — je to záznam o spotrebe, nie daňový doklad.
Porovnajte Flex, Team a Scale na stránke hodnoty organizácie. Žiadosť o plán zachytí ponuku, ktorá sa vám zobrazila; owner ju musí potvrdiť a platí od budúceho prvého dňa mesiaca. Existujúce podmienky sa spätne nikdy nemenia.
Owner a developer môžu vytvárať a rušiť API kľúče. Finance vidí výkazy a plány, nie kľúče. Viewer má prístup iba na čítanie. O tom, kto akú rolu má, rozhoduje owner.
Táto časť je pre správcu brány. Odkazy otvárajú externé stránky; tajný kľúč vložte až do zabezpečeného formulára Poskytovatelia v MEXCOR.
openaianthropicPoužite kľúč jedného pracovného priestoru. Aktuálny adaptér MEXCOR nenastavuje hlavičku na výber priestoru pre multi-workspace kľúče.
geminiStarý Standard kľúč nahraďte podľa aktuálneho migračného návodu Google. Tento adaptér používa Gemini API; neprijíma Vertex AI service-account JSON.
xaiopenrouterManagement API key slúži na správu kľúčov, nie na generovanie odpovedí. Modely v MEXCOR musia mať presný identifikátor z OpenRouter. Stránka Katalóg OpenRouter vie synchronizovať a prehliadať celý zoznam modelov OpenRouter vrátane bezplatných (:free), priamo v konzole.
cerebrasBezplatná úroveň nevyžaduje platobnú kartu. Kontext je dočasne obmedzený nižšie ako pri platených úrovniach; overte aktuálny limit pre zvolený model.
groqLimity platia na celý účet, nie na jeden kľúč. Vhodné pre rýchle požiadavky s nízkou latenciou; denný strop je pri väčšine modelov nižší než u Cerebras.
deepseekCeny bývajú výrazne nižšie ako u OpenAI/Anthropic pri porovnateľnej kvalite a mimo špičky (UTC) sú ešte lacnejšie — pred nastavením cien overte aktuálny cenník.
customJeden vlastný endpoint na bránu. Jeden server s viacerými modelmi — bežný prípad pri Ollama/vLLM — stále potrebuje len jeden záznam Providera, s jedným záznamom AiModel na každý hostovaný model.
photoroomheygenKonfiguráciu poskytovateľov a modelov vykonáva oprávnený správca brány.
MEXCOR_BASE_URL=https://YOUR_GATEWAY_DOMAIN/api/v1 MEXCOR_API_KEY=YOUR_MEXCOR_PROJECT_KEY MEXCOR_SIGN_REQUESTS=false
GET /api/v1/connection Authorization: Bearer YOUR_MEXCOR_PROJECT_KEY
Funkčná požiadavka za menej ako minútu. Tu je tvar požiadavky/odpovede a spracovanie chýb; kompletný prehľad endpointov a klientske knižnice nájdete v technickom návode nižšie.
Každá požiadavka potrebuje váš projektový kľúč ako Bearer token. Podpisovanie (HMAC) je pre projekt voliteľné — zapnite ho v Bezpečnosti, ak ho váš projekt vyžaduje.
Bežné dokončenie chatu. task je predvolene "chat"; brána vyberie model podľa pravidiel smerovania vášho projektu.
POST /api/v1/ai/chat
Authorization: Bearer YOUR_MEXCOR_PROJECT_KEY
Content-Type: application/json
{"messages": [{"role": "user", "content": "Hello"}], "max_tokens": 200}{"output": {"content": "Hi! How can I help?"}, "provider": "openai", "usage": {"cost_nano_usd": 135000}}Pridajte "stream": true pre odpoveď typu Server-Sent Events — event: delta pre každý token, event: completed s finálnou spotrebou, event: error ak poskytovateľ zlyhá už počas streamovania (spotreba v tomto prípade ostáva neistá, nikdy sa tichoto neúčtuje dvakrát).
{"messages": [{"role": "user", "content": "Hello"}], "stream": true}Pri každej požiadavke, ktorú môžete zopakovať (timeout, výpadok spojenia), pošlite hlavičku Idempotency-Key. Opätovné použitie rovnakého kľúča vráti pôvodný výsledok namiesto dvojitého účtovania — po timeoute podľa návodu vyššie najprv skontrolujte stav, až potom skúšajte znova.
Idempotency-Key: YOUR_UNIQUE_REQUEST_ID
Chyby vracajú JSON error.code, napríklad AI_RATE_LIMIT (429, konkrétny model je dočasne nedostupný — brána ho sama na chvíľu vynechá a skúsi ďalší model z vašich pravidiel smerovania), AI_UNAVAILABLE alebo AI_PROVIDER_AUTH_FAILED. Limit rozpočtu alebo MEXCOR vracia 429 s Retry-After.
{"error": {"code": "AI_RATE_LIMIT", "message": "..."}}Oficiálne JS a PHP klienty aj návody na integráciu s Laravel a WordPress nájdete v stiahnuteľnom technickom návode — pokrýva aj vision, tools, embeddings, štruktúrovaný výstup, úpravu obrázkov a pamäť naprieč konverzáciami.
Nie. Jeden aktívny poskytovateľ s overeným modelom a povoleným projektom stačí. Pre každý ďalší priamy prístup potrebujete jeho vlastný kľúč.
Pre MEXCOR potrebujete API kľúč z vývojárskej konzoly a dostupnú API kvótu. Stav predplatného chatovacej aplikácie nie je overením API fakturácie; skontrolujte ju v účte poskytovateľa.
Je to zámer. Pole poskytovateľa je pri úprave prázdne a zachová existujúci kľúč, kým nezadáte nový. Projektový kľúč sa ukáže iba pri vydaní; pri strate vytvorte nový a starý zrušte.
Zákaznícky portál nespravuje globálnych poskytovateľov. Požiadajte správcu brány o pripojenie poskytovateľa. Interný účet potrebuje providers.manage; čítanie sekcie samo neoprávňuje na zmenu kľúča.
Pri /connection skontrolujte projektový kľúč mx_…, jeho expiráciu, zrušenie, projekt a organizáciu. Nepoužívajte tu kľúč OpenAI. Ak zlyhá až provider pokus, správca preverí kľúč uložený v Poskytovateľoch a prístup k modelu.
Overte požadované scopes a IP pravidlá. Pri HMAC zapnite podpisovanie, synchronizujte čas servera a pri každom pokuse použite nový nonce. Telo sa po podpise nesmie meniť. Kľúč musí patriť správnemu prostrediu.
Prečítajte kód chyby a Retry-After. Rozlišujte limity MEXCOR, rozpočet projektu a kvótu/kredity poskytovateľa. Neisté rezervácie môžu stále blokovať rozpočet; správca ich skontroluje vo Vyrovnaní nákladov.
Skontrolujte aktívneho poskytovateľa, aktívny model, overenú cenu, presné model_id, funkcie modelu a povolenia projektu. Požiadavka môže model vylúčiť aj pre cenu, veľkosť kontextu alebo stav dostupnosti.
Nie. Overuje iba prístup do MEXCOR. Funkčnosť konkrétneho poskytovateľa potvrdí až úspešné volanie jeho modelu; to môže byť platené. Samotný stav Aktívne ani uloženie formulára nie sú testom kľúča.
Localhost označuje server, na ktorom beží portál, nie server brány. Použite dostupnú HTTPS adresu MEXCOR zakončenú /api/v1 a overte DNS, certifikát a firewall.
Okamžite ho zrušte tam, kde vznikol: provider kľúč u poskytovateľa, projektový kľúč v MEXCOR. Vytvorte náhradu, aktualizujte server portálu alebo bránu a skontrolujte spotrebu a audit. Samotné zmazanie zo screenshotu alebo Gitu nestačí.
Názov projektu, prostredie, čas s časovou zónou, endpoint, HTTP stav, kód chyby a request/trace ID. Pridajte kroky na zopakovanie bez citlivého obsahu. Neposielajte API kľúč, Authorization hlavičku ani osobné údaje z promptu.
Nič sa nenašlo. Skúste kratší výraz alebo vymažte vyhľadávanie.