Быстрый старт

От регистрации до первого ответа модели за пару минут.

1. Регистрация и API-ключ

Создайте аккаунт и откройте раздел «API-ключи» в кабинете. Ключ доступен на тарифах «Базовый» и «Про»: на бесплатном «Старте» работает только веб-чат. Ключ создаётся одной кнопкой и показывается только один раз — сохраните его сразу.

Войти Начать бесплатно

2. Базовый URL

Все запросы идут на базовый URL с суффиксом /v1. Подставьте его в настройки инструмента или в переменную окружения.

https://api.cosmos-llm.ru/v1

3. Первый запрос

Замените $COSMOS_API_KEY на свой ключ и отправьте запрос к модели cosmos-fast.

curl https://api.cosmos-llm.ru/v1/chat/completions \
  -H "Authorization: Bearer $COSMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cosmos-fast",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cosmos-llm.ru/v1",
    api_key=os.environ["COSMOS_API_KEY"],
)

response = client.chat.completions.create(
    model="cosmos-fast",
    messages=[{"role": "user", "content": "Привет!"}],
)

print(response.choices[0].message.content)
print(response.usage)

const response = await fetch("https://api.cosmos-llm.ru/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.COSMOS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "cosmos-fast",
    messages: [{ role: "user", content: "Привет!" }],
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content, data.usage);

Ожидаемый ответ

Поле usage показывает расход токенов: prompt, completion и total. Эти токены списываются из пула вашего тарифа.

200 OK

{
  "id": "chatcmpl-9f2c1a",
  "object": "chat.completion",
  "created": 1750000000,
  "model": "cosmos-fast",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Привет! Чем помочь?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21 }
}

Частые ошибки на старте

404 при запросе

В базовом URL нет суффикса /v1 либо путь указан без chat/completions.

401 Unauthorized

Ключ не передан или передан без префикса Bearer.

404 model_not_found

Неизвестный алиас модели. Допустимые алиасы: cosmos-fast, cosmos-coder и cosmos-strong; доступный набор зависит от тарифа.

429 Too Many Requests

Превышен лимит запросов в минуту. Подождите время из заголовка Retry-After.

Что дальше

Полный контракт API, коды ошибок и лимиты описаны в следующих разделах.

API Ошибки Лимиты