Docs

快速开始

最后更新: 2026-07-21阅读约 3 分钟

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,在完成时收到通知。生成的文件通过我们的域名以产物形式提供。

浏览全部接口

交互式浏览器

https://developers.grem.capital/docs 的 Swagger UI 中实时试用请求。

OpenAPI 规范

https://developers.grem.capital/openapi.json 导入 Postman 或 Insomnia,也可用它生成客户端。

先读要点

常见问题

在哪里获取 API 密钥?

在后台:AI 工具 > API 的“密钥”标签页。密钥内容只显示一次 — 请立即复制。

基础地址是什么?

https://developers.grem.capital/api/v1

怎么确认密钥可用?

调用 GET /ping — 这个调用不计费。

读取请求会计费吗?

不会。GET 请求不计入 API 调用次数,也不从钱包扣费,包括轮询异步任务的状态。

调用返回 402 该怎么办?

说明钱包余额不足或套餐额度已用完。请充值,或升级到更高的套餐。

这篇文章对您有帮助吗?