开发文档

商户通过服务端签名调用绘城智算 API

签名鉴权

SecretAccessKey 只能放在商户服务端,禁止放入浏览器、小程序或 APP 前端代码。

X-HC-Access-Key: hc_live_xxx
X-HC-Timestamp: 1782871200
X-HC-Nonce: unique_nonce
X-HC-Request-Id: merchant_request_id
X-HC-Signature: hmac_sha256

查询余额

GET /openapi/v1/account/balance

创建材料

POST /openapi/v1/materials
{
  "sku":"HC-YW-12024",
  "name":"云雾灰岩板",
  "category":"stone_slab",
  "width_mm":1200,
  "height_mm":2400,
  "texture_url":"https://merchant.example.com/material.jpg"
}

空间分析

POST /openapi/v1/scenes/analyze
{ "image_url":"https://merchant.example.com/room.jpg" }

材料渲染

POST /openapi/v1/material-renders
{
  "scene_id":"SCENE_xxx",
  "material_id":"MAT_xxx",
  "surface_ids":["floor_01"],
  "output":{"resolution":"2k"}
}

任务查询

GET /openapi/v1/jobs/{job_id}