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 або згенеруйте клієнта.