通过 API Key 接入 CityEngine 与 Runtime 双解析引擎,把 CGA 规则代码编译为三维模型。 按调用次数计费,随充随用,1 元/次。
engine=runtime 走自研 Runtime 解析器,秒级返回 RuntimeScene;
engine=ce 走 CityEngine 编译链路,输出标准 GLB 模型。
注册后在控制台创建 API Key,请求头携带 X-API-Key 即可调用。
支持 client_request_id 幂等去重,网络重试不会重复扣费。
先充值后调用,成功才扣费(1 元/次)。余额不足返回 HTTP 402。 支持支付宝、微信支付即时到账,控制台可查每笔流水。
多台 CityEngine 工作站与云服务器组成解析舰队,实时状态公开透明, 见 节点舰队页。
POST /api/v1/parse,请求头 X-API-Key: avk_...:
curl -X POST https://www.avada.cn/api/v1/parse \ -H "X-API-Key: avk_你的Key" \ -H "Content-Type: application/json" \ -d '{ "source": "Lot --> extrude(10) color(0.2,0.6,1) B", "engine": "runtime", "client_request_id": "req-001" }'
| 字段 | 说明 |
|---|---|
source | CGA 规则代码(必填) |
engine | runtime(默认)或 ce |
attributes | 规则属性参数(可选) |
initialShape | 初始形状(可选,ce 引擎默认 10×10 地块) |
client_request_id | 幂等键(可选,建议携带) |
成功返回 { usage_id, cost, balance, result },其中 result 为引擎原始输出
(runtime 返回 RuntimeScene JSON,ce 返回 base64 GLB)。
| 状态码 | 含义 |
|---|---|
200 | 解析成功,已扣费 1 元 |
401 | API Key 缺失 / 无效 / 已停用 |
402 | 余额不足,请先充值 |
409 | 幂等键冲突 |
502 | 解析引擎失败(不扣费) |
控制台选择金额后调起支付宝或微信支付,支付成功即时入账。
充值接口:POST /api/v1/payments/alipay/create /
POST /api/v1/payments/wechat/create,返回支付链接或扫码二维码。