Cursor s ColdHost API – jak přidat vlastní model do editoru

Cursor je editor postavený na VS Code s hlubokou integrací AI. Kromě vlastních modelů umožňuje zadat vlastní API klíč a přepsat adresu OpenAI endpointu. Díky tomu v něm můžete používat modely ColdHost AI. Tento návod ukazuje nastavení a hlavně upozorňuje na omezení, o kterých je dobré vědět předem.

Údaje pro připojení

Položka	Hodnota
Base URL	https://coldhost-ai.cz/v1
API klíč	z Nastavení → API v ColdHost AI
Modely	coldhost-frost, coldhost-glacier, coldhost-polaris

Nastavení krok za krokem

Rozhraní Cursoru se mezi verzemi mění, princip ale zůstává stejný:

1. Otevřete Cursor Settings (ikona ozubeného kola, případně Ctrl+Shift+J / Cmd+Shift+J).
2. Přejděte do sekce Models.
3. V části s API klíči najděte OpenAI API Key a vložte klíč z ColdHost AI.
4. Zapněte Override OpenAI Base URL a zadejte https://coldhost-ai.cz/v1.
5. Přidejte vlastní model (Add model / Add custom model) s názvem coldhost-glacier. Stejně přidejte i coldhost-polaris, pokud ho chcete používat.
6. Klíč ověřte tlačítkem Verify, pokud ho vaše verze nabízí.
7. Nově přidané modely zapněte a ostatní modely, které nechcete omylem používat, vypněte.

Poté v panelu chatu vyberte v roletce modelů coldhost-glacier.

Co vlastní model v Cursoru ovlivní a co ne

Tady je potřeba mít realistická očekávání:

• Chat a inline úpravy (Ctrl+K / Cmd+K, panel chatu) – s vlastním modelem fungují.
• Tab autocomplete – Cursor používá vlastní specializovaný model, který nelze nahradit vlastním API klíčem.
• Některé pokročilé funkce (např. agentní režimy) mohou s vlastními modely fungovat omezeně nebo vůbec – záleží na verzi Cursoru a jeho aktuálních podmínkách.
• Požadavky s vlastním klíčem jdou přes servery Cursoru, proto musí být endpoint veřejně dostupný – což https://coldhost-ai.cz/v1 je.

Pokud chcete mít ColdHost AI ve všech funkcích včetně autocomplete, je vhodnější VS Code s rozšířením Continue, kde můžete pro doplňování použít coldhost-frost.

Pozor na přepsání base URL

Override OpenAI Base URL se týká všech modelů, které Cursor posílá přes OpenAI klíč. Pokud jste dříve používali vlastní klíč OpenAI pro jiné modely, po přepnutí půjdou požadavky na ColdHost AI a modely, které tam neexistují, budou vracet chybu. Proto ostatní OpenAI modely v seznamu vypněte.

Ověření spojení mimo Cursor

Než začnete ladit nastavení editoru, ověřte, že klíč funguje:

curl -s https://coldhost-ai.cz/v1/chat/completions \
  -H "Authorization: Bearer VAS_API_KLIC" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "coldhost-glacier",
    "messages": [{"role": "user", "content": "Napiš jedno slovo: funguje"}]
  }'

Pokud dostanete JSON s odpovědí, klíč i endpoint jsou v pořádku a případný problém je v nastavení Cursoru.

Časté chyby

Příznak	Příčina	Řešení
Verify selže	překlep v klíči nebo URL	zkontrolujte /v1 na konci, bez lomítka
„Model not found“	špatný název modelu	přesně coldhost-glacier apod.
Funguje chat, ne Tab	Tab používá model Cursoru	očekávané chování
Požadavky odmítnuty	došel API kredit	dobijte API kredit v Kč

Tipy pro práci

• Pro běžný chat volte coldhost-glacier, na složitější refaktoring coldhost-polaris (3× dražší).
• Do projektu přidejte soubor s pravidly (Cursor podporuje pravidla projektu v .cursor/rules/), ať nemusíte styl kódu opakovat v každém dotazu.
• Spotřeba jde z API kreditu, ne z limitu webového chatu ColdHost AI – obojí tedy můžete používat souběžně.

Shrnutí

Cursor s ColdHost API funguje dobře pro chat a inline úpravy. Pokud vám jde hlavně o to mít modely Frost, Glacier a Polaris všude v editoru, sáhněte po VS Code s Continue; pokud máte Cursor rádi kvůli jeho rozhraní, vlastní endpoint je rozumný kompromis.