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 пробрасываются как есть. Ассоль проверяет токен и одно правило: модель из запроса уже должна быть загружена.
409 model_not_loaded, запрос в Ollama не уходит. Набор загруженных моделей меняется только вручную в Ассоли (или ollama run). keep_alive в запросе принудительно ставится в -1, поэтому клиент не может выгрузить модель.Клиенты (Kilo Code, Cursor, Cline, SDK) настраиваются как на обычный OpenAI-провайдер:
- Base URL:
https://api.assol.space/v1 - API key: токен API
- Model: любая уже загруженная (например
gpt-oss:120b); список установленных —GET /v1/models, загруженных — в Ассоли
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)
- Открой настройки провайдеров Kilo (Providers → Add provider → OpenAI Compatible).
- Base URL:
https://api.assol.space/v1— без/openaiи без слэша на конце. - API key: токен из Настройки → Токены API.
- Models → Fetch models — подтянется список Ollama. Выбери
gpt-oss:120b(или другую). Если список не пришёл, добавь модель вручную: ID — точный тег Ollama, Name — любой. - Для
gpt-ossвключи Reasoning; не оставляй IDassol— это имя провайдера, а не модели.
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:
401— нет или неверный токен API;409(model_not_loaded) — модели нет в памяти; загрузи её вручную в Ассоли;- ошибки Ollama (400/404/500) пробрасываются как есть, в формате Ollama;
503— Ассоль обновляется, повтори через минуту.
Лимиты
/v1— стандартный Ollama: ограничения модели и её контекста./assol/v1— ожидание ответа API-сессии доASSOL_API_WAIT_S(600 с), дальше можно запросить/result.- Тело запроса к
/v1— до 32 МБ.