ColdHost AI API

REST API kompatibilní s OpenAI Chat Completions. Pokud už používáš knihovnu openai, stačí změnit base_url a klíč.

Základní URL: https://coldhost-ai.cz/v1
Autentizace: hlavička Authorization: Bearer ch-…

Rychlý start

Přihlas se a v Nastavení → API si kup balíček tokenů (Ultra má 2M tokenů měsíčně v ceně).
Vytvoř API klíč a bezpečně si ho ulož – zobrazí se jen jednou.
Pošli první požadavek:

curl https://coldhost-ai.cz/v1/chat/completions \
  -H "Authorization: Bearer $COLDHOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "coldhost-glacier",
    "messages": [{"role": "user", "content": "Ahoj, kdo jsi?"}]
  }'

Modely

Model	Popis	Max. výstup
`coldhost-frost`	Frost – bleskový model pro rychlé odpovědi a jednoduché úlohy.	8 192 tokenů
`coldhost-glacier`	Glacier – vyvážený model pro kód, texty a analýzy. Podporuje volání nástrojů (`tools`). Doporučeno.	8 192 tokenů
`coldhost-polaris`	Polaris – hluboké uvažování pro nejtěžší úlohy. Vrací i `reasoning_content`.	32 000 tokenů

POST /v1/chat/completions

Parametr	Typ	Popis
`model`	string	`coldhost-frost`, `coldhost-glacier` (výchozí) nebo `coldhost-polaris`
`tools`, `tool_choice`	array	Volání funkcí ve formátu OpenAI (Frost, Glacier).
`messages`	array	1–300 zpráv `{role: system\|user\|assistant, content: string}`
`max_tokens`	int	Maximální délka odpovědi.
`temperature`	float	0–2 (u Polarisu se ignoruje).
`stream`	bool	Streamování přes Server-Sent Events.
`stream_options.include_usage`	bool	Poslat spotřebu tokenů v posledním chunku.

Python (openai)

from openai import OpenAI

client = OpenAI(base_url="https://coldhost-ai.cz/v1", api_key="ch-...")

stream = client.chat.completions.create(
    model="coldhost-glacier",
    messages=[
        {"role": "system", "content": "Odpovídej stručně."},
        {"role": "user", "content": "Napiš funkci pro validaci e-mailu v Pythonu."},
    ],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

JavaScript / Node.js

const res = await fetch("https://coldhost-ai.cz/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.COLDHOST_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "coldhost-glacier",
    messages: [{ role: "user", content: "Ahoj!" }],
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);

PHP

$ch = curl_init("https://coldhost-ai.cz/v1/chat/completions");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("COLDHOST_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "model" => "coldhost-glacier",
        "messages" => [["role" => "user", "content" => "Ahoj!"]],
    ]),
]);
$data = json_decode(curl_exec($ch), true);
echo $data["choices"][0]["message"]["content"];

Odpověď

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "coldhost-glacier",
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "Ahoj! …" }, "finish_reason": "stop" }],
  "usage": { "prompt_tokens": 412, "completion_tokens": 58, "total_tokens": 470 }
}

Účtování a limity

Platí se z API kreditu v Kč podle skutečně zpracovaných tokenů – aktuální ceny za 1 milion tokenů:

Typ tokenů	Cena za 1M
Načítám…

U tarifů Pro a Ultra se požadavky přes API (i z VS Code) nejdřív čerpají z tokenů tarifu, kredit až potom.
Limit: 120 požadavků za minutu na klíč. Kredit a útratu klíčů vidíš v Nastavení → API.

VS Code, Cursor a agenti

API je kompatibilní s OpenAI, takže funguje všude, kde lze nastavit vlastní „OpenAI-compatible“ endpoint:

Continue (VS Code, JetBrains) – provider openai, apiBase: https://coldhost-ai.cz/v1, model coldhost-glacier.
Cline / Roo Code – provider OpenAI Compatible, Base URL https://coldhost-ai.cz/v1, Model ID coldhost-glacier.
Cursor – Settings → Models → Override OpenAI Base URL.

Chyby

Kód	Význam
400	Neplatný požadavek (model, zprávy, parametry).
401	Chybějící nebo neplatný API klíč.
402	Došel kredit tokenů – dobij si balíček.
413	Požadavek je příliš velký.
429	Překročen limit požadavků.
502	Model je dočasně nedostupný – zkus to znovu.

Chyby mají formát {"error": {"message": "…", "type": "…"}}.