签名鉴权
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}