MEXCOR · Začnite tu

Centrum pomoci a FAQ

Od prvého API kľúča po fungujúci portál. Postupy pre správcu brány aj zákazníka, na jednom mieste.

Začnite tu

01

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.

02

Zákazník / vývojár portálu

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.

Práca s konzolou

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.

01

Projekty a rozpočty

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ý.

02

Pravidlá smerovania

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.

03

Upozornenia a webhooky

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.

04

Sledovanie kvality a nákladov

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.

05

Poradca pre lacnejší model

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.

06

Tím a bezpečnosť

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.

07

Zálohy a pripravenosť

Š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.

Používanie vášho portálu

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).

01

Vaše organizácie

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.

02

Projekty

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).

03

API kľúče

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.

04

Spotreba a výkazy

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.

05

Plány

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.

06

Role

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.

Kľúče poskytovateľov

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.

OpenAI

openai
  1. Prihláste sa do OpenAI Platform a zvoľte projekt pre bránu.
  2. Na stránke API keys vytvorte nový tajný kľúč a bezpečne ho skopírujte.
  3. V nastaveniach účtu overte API fakturáciu a oprávnenie používať vybraný model.

Anthropic / Claude

anthropic
  1. Prihláste sa do Claude Console a vyberte pracovný priestor.
  2. V Settings → API keys vytvorte kľúč pre tento pracovný priestor.
  3. Skopírujte kľúč a skontrolujte fakturáciu, limity a jeho platnosť.

Použite kľúč jedného pracovného priestoru. Aktuálny adaptér MEXCOR nenastavuje hlavičku na výber priestoru pre multi-workspace kľúče.

Google Gemini

gemini
  1. Prihláste sa do Google AI Studio a otvorte API Keys.
  2. Zvoľte Create API key a projekt; existujúci Cloud projekt najskôr importujte, ak ho nevidíte.
  3. Skopírujte nový auth kľúč; podľa potreby projektu nastavte billing.

Starý 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.

OpenRouter

openrouter
  1. Prihláste sa do OpenRouter a otvorte Settings → Keys.
  2. Vytvorte bežný API kľúč pre volanie modelov a nastavte limit, ak je dostupný.
  3. Skopírujte kľúč a pre platené modely pridajte kredity.

Management 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.

Cerebras (free tier)

cerebras
  1. Prihláste sa do Cerebras Cloud Platform (cloud.cerebras.ai) a otvorte API Keys.
  2. Vytvorte nový kľúč a skopírujte ho.
  3. Bezplatná úroveň sa denne resetuje s pevným stropom tokenov; pred nasadením do produkcie overte aktuálne limity.

Bezplatná úroveň nevyžaduje platobnú kartu. Kontext je dočasne obmedzený nižšie ako pri platených úrovniach; overte aktuálny limit pre zvolený model.

Groq (free tier)

groq
  1. Prihláste sa do GroqCloud konzoly (console.groq.com) a otvorte API Keys.
  2. Vytvorte nový kľúč a skopírujte ho.
  3. Skontrolujte minútové aj denné limity bezplatnej úrovne pre zvolený model; líšia sa podľa modelu.

Limity 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.

DeepSeek

deepseek
  1. Prihláste sa do DeepSeek Platform (platform.deepseek.com) a otvorte API Keys.
  2. Vytvorte nový kľúč a skopírujte ho — zobrazí sa len raz.
  3. Najprv dobite kredit; na rozdiel od Cerebras/Groq ide o platbu za spotrebu, nie o bezplatnú úroveň.

Ceny 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.

Custom / self-hosted (Ollama, vLLM, LM Studio…)

custom
  1. Nainštalujte a spustite OpenAI-kompatibilný inferenčný server na vlastnej infraštruktúre — Ollama, vLLM, LM Studio alebo text-generation-inference — s open-weight modelmi ako Llama či Mistral.
  2. Zistite jeho chat-completions URL, napr. http://localhost:11434/v1/chat/completions pre Ollama, a prípadný prístupový token.
  3. V Poskytovatelia vytvorte jeden záznam s ovládačom custom, vložte základnú URL a kľúč (mnohé self-hosted servery akceptujú akúkoľvek neprázdnu hodnotu), potom pridajte každý hostovaný model ako samostatný záznam AiModel — pri bezplatnej prevádzke s cenou 0.

Jeden 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.

HeyGen

heygen
  1. Prihláste sa do HeyGen a otvorte Settings → API.
  2. Vygenerujte API kľúč. Prístup k API vyžaduje platený Creator/Enterprise plán, nie bezplatnú spotrebiteľskú úroveň appky.
  3. Skopírujte ho a skontrolujte zostávajúce sandbox minúty oproti plateným cenám za sekundu.

Oficiálne zdroje overené 19. 9. 2026. Názvy tlačidiel sa môžu meniť; aktuálny postup nájdete aj v priložených zdrojoch.

Uloženie do MEXCOR

  1. V hlavnej navigácii otvorte Poskytovatelia. Pri existujúcom zázname kliknite na Upraviť; inak na Vytvoriť.
  2. Vyplňte názov a zvoľte zodpovedajúci ovládač, napríklad openai, anthropic, gemini, cerebras, groq, deepseek, custom alebo openrouter. Každý ovládač okrem custom má jeden záznam.
  3. Do poľa API key vložte iba samotný tajný kľúč, bez Bearer, úvodzoviek alebo názvu premennej. Nenahráva sa žiadny súbor.
  4. Zapnite Aktívne a uložte formulár. Pri ďalšom otvorení ostáva pole kľúča prázdne: prázdna hodnota zachová existujúci kľúč, nová ho nahradí. Uloženie samo neoveruje funkčnosť.
  5. Otvorte Modely, vytvorte alebo upravte model daného poskytovateľa. Zadajte presné model_id, podporované funkcie, kontext a limity. Overte aktuálne vstupné, výstupné a cache ceny; 1 USD / milión tokenov = 1 000 000 micro-USD. Až potom označte cenu ako overenú a model aktivujte.
  6. V Projekte povoľte poskytovateľa aj model, nastavte kladný denný a mesačný rozpočet a správne prostredie. Nový zákaznícky projekt je do schválenia zablokovaný nulovým rozpočtom a prázdnymi zoznamami povolení.

Konfiguráciu poskytovateľov a modelov vykonáva oprávnený správca brány.

Pripojenie vášho portálu

  1. Interný správca: API kľúče → Vytvoriť API kľúč. Zákazník: Môj portál → organizácia → projekt → Vytvoriť API kľúč.
  2. Vyberte projekt a prostredie. Na začiatok použite staging a oprávnenia chat + read. Ďalšie oprávnenia pridajte iba pre používané funkcie, napríklad embeddings alebo vision.
  3. Pomenujte kľúč podľa portálu. Celú hodnotu mx_… uložte hneď pri vytvorení do správcu tajomstiev; neskôr ju nemožno znovu zobraziť.
  4. Na serveri pripájaného portálu nastavte MEXCOR_BASE_URL a MEXCOR_API_KEY. Ak projekt vyžaduje HMAC, zapnite podpisovanie v klientovi. Kľúč patrí do serverového prostredia, nie do JavaScriptu v prehliadači.
  5. Použite stiahnuteľný PHP/Node klient alebo Laravel/WordPress návod. Po zmene tajomstva obnovte konfiguráciu a reštartujte príslušné procesy portálu podľa jeho spôsobu nasadenia.
MEXCOR_BASE_URL=https://YOUR_GATEWAY_DOMAIN/api/v1
MEXCOR_API_KEY=YOUR_MEXCOR_PROJECT_KEY
MEXCOR_SIGN_REQUESTS=false

Overenie pripojenia

  1. Najskôr cez dodaný klient zavolajte GET /api/v1/connection s projektovým kľúčom a oprávnením read. Pri HMAC musí byť podpísané aj toto volanie.
  2. Očakávajte connected: true, správny projekt, prostredie a scopes. Tento krok nevolá AI poskytovateľa a nepotvrdzuje platnosť jeho kľúča. available_models vyjadruje dostupnosť podľa konfigurácie smerovania.
  3. Potom vykonajte jednu krátku požiadavku s nízkym max_tokens, max_cost a staging rozpočtom. Je to potenciálne platené volanie. V Testovacom prostredí zvoľte konkrétny model poskytovateľa, ktorého overujete.
  4. V AI požiadavkách skontrolujte stav, skutočne použitý model, pokusy a náklady. Pri chybe uložte request/trace ID. Pri timeoute neopakujte požiadavku naslepo: použite rovnaký idempotency key a skontrolujte stav.
GET /api/v1/connection
Authorization: Bearer YOUR_MEXCOR_PROJECT_KEY

Návod pre vývojárov / API

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.

Základná URL a autentifikácia

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.

Vaša prvá požiadavka

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}}

Streamovanie

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}

Idempotencia a opakovania

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 a limity

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": "..."}}

Klientske knižnice

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.

Výmena a ochrana kľúčov

  1. Kľúč poskytovateľa: vytvorte nový u poskytovateľa, nahraďte ho cez Poskytovatelia → Upraviť, overte krátke volanie a až potom zrušte starý u poskytovateľa. Pri úniku zrušte kompromitovaný kľúč okamžite.
  2. Projektový kľúč: interný správca môže v API kľúčoch použiť Rotovať s prekrytím 0–1440 minút. Zákazník vytvorí nový kľúč v projekte, aktualizuje portál, overí pripojenie a zruší starý. Stratený kľúč obnovte vytvorením nového.
  3. Nikdy nevkladajte tajomstvá do FAQ, screenshotov, Git repozitára, chatu ani verejného formulára. Používajte HTTPS, 2FA a minimálne oprávnenia. Kľúče poskytovateľov sú uložené šifrovane; projektové kľúče ako hash.
  4. APP_KEY, BACKUP_ENCRYPTION_KEY, databázové heslo a webhook secret sú prevádzkové tajomstvá. Nenahrávajú sa do poľa API key poskytovateľa. HMAC projektových požiadaviek používa samotný projektový kľúč; nevytvárajte preň ďalší provider účet.

Často kladené otázky

Potrebujem všetkých poskytovateľov?

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ľúč.

Stačí predplatné chatovacej aplikácie?

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.

Prečo po uložení nevidím kľúč?

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.

Nevidím Poskytovateľov alebo tlačidlo Vytvoriť.

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.

Čo znamená 401 alebo neplatný kľúč?

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.

Prečo je požiadavka zakázaná (403)?

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.

Čo robiť pri 429 alebo vyčerpanom rozpočte?

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.

Kľúč je uložený, ale nie je dostupný model.

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.

Potvrdzuje /connection funkčnosť OpenAI či Gemini?

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.

Prečo môj vzdialený portál nefunguje s localhost?

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.

Čo robiť pri úniku kľúča?

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čí.

Čo poslať správcovi pri probléme?

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.