三维模型世界
解析服务器平台

通过 API Key 接入 AVADA 自研 Runtime 解析器与标准编译链路，把 CGA 规则代码编译为三维模型。 按调用次数计费，随充随用，1 元/次。

立即接入 查看接入文档

产品能力

一个 API Key，两套解析链路，按需调用

双链路解析

engine=runtime 走自研 Runtime 解析器，秒级返回 RuntimeScene； engine=ce 走标准编译链路，输出标准 GLB 模型。

API Key 接入

注册后在控制台创建 API Key，请求头携带 X-API-Key 即可调用。 支持 client_request_id 幂等去重，网络重试不会重复扣费。

余额制计费

先充值后调用，成功才扣费（1 元/次）。余额不足返回 HTTP 402。 支持支付宝、微信支付即时到账，控制台可查每笔流水。

定价

简单透明，按次计费
¥1 / 次
  • 成功调用才扣费，失败不计费
  • 支付宝 / 微信支付即时到账
  • 幂等键防重复扣费，可放心重试
  • 控制台实时余额、调用记录、充值流水
注册并充值

接入文档

三步接入：注册 → 创建 API Key → 调用 /api/v1/parse

1. 调用解析接口

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"
  }'

2. 请求参数

字段说明
sourceCGA 规则代码（必填）
engineruntime（默认）或 ce
attributes规则属性参数（可选）
initialShape初始形状（可选，ce 引擎默认 10×10 地块）
client_request_id幂等键（可选，建议携带）

3. 返回与错误码

成功返回 { usage_id, cost, balance, result }，其中 result 为引擎原始输出 （runtime 返回 RuntimeScene JSON，ce 返回 base64 GLB）。

状态码含义
200解析成功，已扣费 1 元
401API Key 缺失 / 无效 / 已停用
402余额不足，请先充值
409幂等键冲突
502解析引擎失败（不扣费）

4. 充值

控制台选择金额后调起支付宝或微信支付，支付成功即时入账。 充值接口：POST /api/v1/payments/alipay/create / POST /api/v1/payments/wechat/create，返回支付链接或扫码二维码。