接入文档
1. 创建 Key
注册、登录后,在 API Keys 选择 cga:generate(独立 CGA 生成)并创建正整数配额。明文 key 仅返回一次,请放在服务端。
2. CGA 生成接口
curl -X POST https://www.nl2cga.com/api/v1/cga/generate \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Idempotency-Key: <UUID>' \
-H 'Content-Type: application/json' \
-d '{"prompt":"一栋六层住宅"}'同步返回生成结果(status=succeeded 时 cga 字段为完整规则源码);长任务可改用 POST /api/v1/cga/generate/async 再按 status_url 轮询。每次成功生成实扣 ¥0.02(与控制台 generation_price_cny 一致)。
3. 402 与重试契约
余额不足返回 HTTP 402(响应含 balance_cny / price_cny / buy_url)。仅当 402 且 retryable=true(余额快照同步中)时,按 5/15/25 秒最多重试 3 次,幂等 key 与请求 body 全程复用;其他 402、429、5xx、网络错误不自动重试。
4. 查询与错误
使用响应中的 status_url 查询任务,保存 request_id 排查问题。
5. 能力边界
开放 API 仅提供 CGA 生成能力;3D 预览请在官网 workbench / race 体验。原 Studio text-to-model 端点已停止对外开放(调用返回 403 STUDIO_TEXT_TO_MODEL_DISABLED)。