API для разработчиков GREM позволяет вызывать наши инструменты — оценку недвижимости, генерацию контента, улучшение фото, видео-аватар, генерацию сайтов и PDF, а также AI-чат — программно по HTTPS. Запросы и ответы — в формате JSON.
Базовый URL
Все эндпоинты находятся под базой:
https://developers.grem.capital/api/v1
1. Получите API-ключ
В кабинете откройте AI-инструменты → API и создайте ключ на вкладке Ключи. Секрет (gsk_live_…) показывается один раз — сразу скопируйте его.
Обращайтесь с ключом как с паролем: он даёт доступ к инструментам и биллингу вашего аккаунта. Не коммитьте его в репозиторий и не раскрывайте в браузерном коде.
2. Сделайте первый вызов
GET /ping проверяет ключ и ничего не списывает:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/ping
{ "ok": true, "subjectId": "…", "requestId": "req_…" }
3. Вызовите инструмент
Синхронный пример — экспресс-оценка недвижимости:
curl -X POST https://developers.grem.capital/api/v1/valuation/express \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"propertyCategory":"apartment","totalArea":50}'
{
"estimate": { "pricePoint": 156250, "rangeLow": 125575, "rangeHigh": 207813, "currency": "USD" },
"requestId": "req_…"
}
Долгие инструменты
Инструменты вроде генерации контента, аватара или PDF возвращают задачу (202 с jobId). Опрашивайте статус задачи (опрос бесплатный) или, лучше, подпишитесь на вебхук, чтобы получить уведомление о завершении. Готовые файлы отдаются через наш домен как артефакты.
Изучите все эндпоинты
Интерактивный обозреватель
Пробуйте запросы вживую в Swagger UI: https://developers.grem.capital/docs.
Спецификация OpenAPI
Импортируйте https://developers.grem.capital/openapi.json в Postman или Insomnia либо сгенерируйте клиента.