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-1",
    "messages": [{"role": "user", "content": "Ahoj, kdo jsi?"}]
  }'

Modely

Model	Popis	Max. výstup
`coldhost-1`	Rychlý univerzální model – chat, kód, texty, analýzy.	8 192 tokenů
`coldhost-1-think`	Hluboké uvažování pro náročné úlohy. Vrací i `reasoning_content`.	32 000 tokenů

POST /v1/chat/completions

Parametr	Typ	Popis
`model`	string	`coldhost-1` (výchozí) nebo `coldhost-1-think`
`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, výchozí 0,7 (u `-think` 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-1",
    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-1",
    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-1",
        "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-1",
  "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

Účtují se vstupní i výstupní tokeny (total_tokens). Token ≈ 3–4 znaky textu.
Limit: 120 požadavků za minutu na klíč.
Kredit je sdílený pro všechny tvé klíče; zbývající kredit vidíš v Nastavení → API.

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