Assol API

Алиас домена — https://api.assol.online (те же пути). Один хост — два слоя: стандартный OpenAI-совместимый API Ollama (/v1) и нативный API Ассоли для сессий и режимов (/assol/v1). Оба под одним токеном API.

СлойBase URLДля чего
Стандартный (Ollama/OpenAI) https://api.assol.space/v1 Kilo Code, Cursor, Cline, любые OpenAI-совместимые клиенты: модели, chat completions, tools, стрим.
Нативный API Ассоли https://api.assol.space/assol/v1 Сессии Ассоли с режимами, паузой на вопросе, одобрениями и ожиданием результата.

Авторизация

Токен передаётся заголовком:

Authorization: Bearer aso_…

Токен — из раздела Настройки → Токены API (scope api). Один токен работает и для /v1, и для /assol/v1.

Без токена шлюз /v1 отвечает 401 JSON с ссылкой на эту документацию; нативный API — тоже 401 в общем формате ошибок.

Токены

Создать и отозвать токен можно в UI: Настройки → Токены API. Токен показывается один раз; храни его как пароль.

Токены Ollama (Токены Ollama) — отдельный список для https://ollama.assol.space, к api.assol.space они не подходят.

Стандартный API (/v1)

https://api.assol.space/v1 — OpenAI-совместимый API Ollama. Протокол стандартный: пути, тела, стрим и ошибки Ollama пробрасываются как есть. Ассоль проверяет токен и одно правило: модель из запроса уже должна быть загружена.

API не загружает и не выгружает модели. Если запрошенной модели нет в памяти — 409 model_not_loaded, запрос в Ollama не уходит. Набор загруженных моделей меняется только вручную в Ассоли (или ollama run). keep_alive в запросе принудительно ставится в -1, поэтому клиент не может выгрузить модель.

Клиенты (Kilo Code, Cursor, Cline, SDK) настраиваются как на обычный OpenAI-провайдер:

curl -s https://api.assol.space/v1/models \
  -H "Authorization: Bearer $ASSOL_TOKEN"
curl -s https://api.assol.space/v1/chat/completions \
  -H "Authorization: Bearer $ASSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-oss:120b",
    "messages": [{"role": "user", "content": "Привет"}]
  }'

Поддерживается всё, что умеет Ollama: tools/tool_calls, стрим, /v1/embeddings, /v1/completions и прочее. Поведение и ошибки — стандартные для Ollama.

Наружу открыт только /v1/*. Нативные /api/* Ollama (pull/delete/show) намеренно не выставлены — для них есть https://ollama.assol.space с токенами Ollama.

Модели

В стандартном слое GET /v1/models — это установленные модели Ollama, а не загруженные:

GET https://api.assol.space/v1/models
Authorization: Bearer aso_…

Запрос к модели хаба, которой нет в памяти, отклоняется с 409 — API не грузит её сам. Загрузи модель вручную в Ассоли (или ollama run gpt-oss:120b на хабе) и повтори. Так модель переключает только человек, а не случайный запрос клиента.

В списке также есть модели спутников — sat:<устройство>:<модель>, например sat:dev_…:qwen2.5-coder:14b. Это модель на твоём устройстве: у неё свой контекст (в ответе /v1/models — context_length), и она работает, пока устройство онлайн; если спутник офлайн — 503 satellite_offline. Спутник исполняет модель сам, API только передаёт запрос по RPC.

Нативный API отдаёт модели Ассоли (хаб, спутники, облако) и режимы:

GET https://api.assol.space/assol/v1/models
Authorization: Bearer aso_…

В нативном API model можно не указывать или передать auto — Ассоль выберет свободную локальную модель или спутник (облако — только явной моделью).

Стрим

В стандартном слое стрим — обычный Ollama/OpenAI:

{"model": "gpt-oss:120b", "stream": true,
 "messages": [{"role": "user", "content": "Привет"}]}

Ответ — text/event-stream с кадрами data: {…} и завершением; tools работают так же, как в OpenAI.

В нативном API POST /assol/v1/sessions/{id}/messages с "stream": true отдаёт SSE Ассоли: session, status, delta, ask, approval, done, error.

Подключение клиентов

Оба клиента работают со стандартным слоем /v1: Base URL https://api.assol.space/v1, ключ — токен API. Перед запросом нужная модель должна быть уже загружена в Ассоли — API её не загружает. Модели — теги Ollama из GET /v1/models (например gpt-oss:120b); auto и assol как имя модели не существуют.

Kilo Code (VS Code)

  1. Открой настройки провайдеров Kilo (Providers → Add provider → OpenAI Compatible).
  2. Base URL: https://api.assol.space/v1 — без /openai и без слэша на конце.
  3. API key: токен из Настройки → Токены API.
  4. Models → Fetch models — подтянется список Ollama. Выбери gpt-oss:120b (или другую). Если список не пришёл, добавь модель вручную: ID — точный тег Ollama, Name — любой.
  5. Для gpt-oss включи Reasoning; не оставляй ID assol — это имя провайдера, а не модели.

DeepSeek Harness (DSH)

DSH подключает внешний OpenAI-совместимый провайдер через плагин llm-pi-ai. Добавь в профиль (~/.dsh/profiles/web/cordis.patch.yml):

- id: llm-pi-ai
  config:
    providers:
      assol:
        displayName: Assol
        api: openai-completions
        baseURL: https://api.assol.space/v1
        apiKeyEnv: ASSOL_API_KEY
        defaultContextWindow: 65536
        models:
          - id: "gpt-oss:120b"
            name: GPT-OSS 120B
            contextWindow: 65536
            reasoningEfforts: false

Ключ храни в хранилище DSH, а не в конфиге: ~/.dsh/.credentials.yaml → refs.ASSOL_API_KEY: aso_…. Профиль перечитывается без перезапуска; после этого выбери провайдера Assol и модель в выборе модели DSH.

Для другой модели поменяй id на точный тег из /v1/models (например gpt-oss:20b, qwen3-coder:30b или sat:…:qwen2.5-coder:14b) и поставь её contextWindow/maxTokens — они у моделей разные.

Нативные сессии

Нативный API повторяет то, что делает UI Ассоли: создаёт чат, отправляет сообщение, ждёт результат, отвечает на вопросы и одобрения.

POST https://api.assol.space/assol/v1/sessions
Authorization: Bearer aso_…
Content-Type: application/json

{"title": "Проверка", "mode": "agent", "model": "auto"}

Ответ: {"id": 123, "mode": "agent", "model": "…", …}.

Дальше:

МетодПутьЧто делает
GET/assol/v1/sessionsсписок API-сессий
GET/assol/v1/sessions/{id}состояние сессии
POST/assol/v1/sessions/{id}/messagesсообщение (JSON или SSE)
GET/assol/v1/sessions/{id}/resultдождаться результата
POST/assol/v1/sessions/{id}/stopостановить прогон
GET/assol/v1/sessions/{id}/approvalsожидающие одобрения
POST/assol/v1/approvals/{id}ответить на одобрение

Сообщения

POST https://api.assol.space/assol/v1/sessions/123/messages
Authorization: Bearer aso_…
Content-Type: application/json

{"text": "Сделай кнопку красной", "mode": "agent", "model": "auto", "stream": true}

Без stream вернётся состояние прогона; со stream: true — SSE.

Результат

GET https://api.assol.space/assol/v1/sessions/123/result?timeout=120
Authorization: Bearer aso_…

Ждёт завершения и отдаёт последний ответ Ассоли. Если прогон ещё идёт — running; если Ассоль задала вопрос — ask и текст вопроса.

Одобрения

GET  https://api.assol.space/assol/v1/sessions/123/approvals
POST https://api.assol.space/assol/v1/approvals/7
{"approved": true}

Вопросы и одобрения не подвешивают клиент: текст приходит в результате/SSE, решение отправляется отдельно.

Режимы

В нативном API доступны ask, agent, plan, coder — как в UI. По умолчанию agent.

В стандартном слое /v1 режимов Ассоли нет: это чистый вызов модели, инструменты исполняет клиент.

Ошибки

Нативный API отвечает JSON:

{"error": {"code": "invalid_model", "message": "…", "doc": "https://api.assol.space/doc#models"}}

Шлюз /v1:

Лимиты