GREM 开发者 API 让您可以通过 HTTPS 以编程方式调用我们的工具:房产估价、内容生成、照片增强、数字人视频、网站与 PDF 生成,以及 AI 聊天。请求和响应均为 JSON。
基础地址
所有接口都位于该地址之下:
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)。可以轮询任务的状态接口(轮询免费),更好的做法是订阅 webhook,在完成时收到通知。生成的文件通过我们的域名以产物形式提供。