Обзор Cloud API

OmniScout Cloud — это облачный API для семантического поиска, обоснованных ответов и удалённых сессий браузера/компьютера. Он использует тот же пайплайн поиска и реранжирования, что и локальный CLI, но на основе собственного индекса Qdrant вместо DuckDuckGo.

Что вы получаете

Что изменилось для вызывающих сессии

POST /v0/search и POST /v0/answer без изменений.

Эндпоинты сессий используют те же пути, что и раньше, со следующими отличиями:

1. Сохраните session_secret из ответа создания — требуется в каждой команде и файловом запросе через x-session-secret.
2. Сессии компьютера унифицированы — один session_id поддерживает и команды браузера (POST /v0/browser/sessions/{id}), и команды компьютера (POST /v0/computer/sessions/{id}). Отдельная сессия браузера больше не нужна, если у вас уже есть сессия компьютера.
3. Имена действий — действия браузера используют короткие имена (navigate, screenshot); действия компьютера используют префикс computer. (computer.type, computer.screenshot).
4. Файловые маршруты — новые — используйте /v0/sessions/{id}/files для загрузки файлов или скачивания скриншотов/PDF из Sprite.
5. Истечение — по неактивности — сессии продлеваются каждой командой (по умолчанию 30 мин простоя, макс. 2 ч). Не полагайтесь на фиксированный TTL от момента создания.

# 1. Создание унифицированной сессии компьютера (только API-ключ)
curl -X POST https://api.omniscout.xyz/v0/computer/sessions \
  -H "Authorization: Bearer $OMNISCOUT_API_KEY"

# Ответ включает session_id, session_secret, capabilities: ["browser","computer"]

# 2. Команда браузера в той же сессии (оба заголовка)
curl -X POST "https://api.omniscout.xyz/v0/browser/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $OMNISCOUT_API_KEY" \
  -H "x-session-secret: $SESSION_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"navigate","args":{"url":"https://example.com"}}'

# 3. Команда компьютера в той же сессии
curl -X POST "https://api.omniscout.xyz/v0/computer/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $OMNISCOUT_API_KEY" \
  -H "x-session-secret: $SESSION_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"action":"computer.type","args":{"text":"hello"}}'

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

1. Зарегистрируйтесь на api.omniscout.xyz (или на URL вашего деплоя).
2. Создайте API-ключ в дашборде — ключи начинаются с os_live_.
3. Отправьте первый запрос:

curl -X POST https://api.omniscout.xyz/v0/search \
  -H "Authorization: Bearer os_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "rust async runtimes", "limit": 10}'

CLI и Cloud

Локальный CLI без изменений. Cloud дополняет его — используйте то, что подходит вашему деплою.

Архитектура

Client → Vercel gateway (/v0/*) → Fly search worker → Qdrant Cloud
                                 → Vercel AI Gateway (answers)
                                 → Fly Sprites (browser/computer)

• Vercel хостит дашборд, API-шлюз, Clerk-аутентификацию и Convex (ключи, использование, сессии).
• Fly.io запускает поисковый воркер, индексер и Sprites.
• Qdrant Cloud хранит собственный поисковый индекс (Common Crawl + StormCrawler, добавочная индексация).

Дальнейшие шаги

• Аутентификация и API-ключи — как создавать и использовать ключи
• Эндпоинты — схемы запросов/ответов для каждого маршрута
• Лимиты — дневные квоты и тарифы
• Справочник OpenAPI — интерактивный проводник API