接入文档

1. 创建 Key

注册、登录后，在 API Keys 选择 studio:generate 并创建正整数配额。明文 key 仅返回一次，请放在服务端。

2. 融合接口

curl -X POST https://cga.cityvistion.com/api/v1/studio/text-to-model \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: <UUID>' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"一栋六层住宅","engine":"auto"}'

3. 402 重试契约

仅当 HTTP 402 且 stage=admission、reason_code=BALANCE_SNAPSHOT_STALE、retryable=true 时，按 5/15/25 秒最多重试 3 次。幂等 key 与冻结 body 全程复用。其他 402、429、5xx、网络错误不自动重试。

4. 查询与错误

使用响应中的 status_url 查询任务，保存 request_id 排查问题。独立 generate/render 权限和普通 402 不套用 Studio 重试保证。