认证

所有涉及账号的接口都需在请求头携带 API Key。产品目录（GET /v1/products）是公开的，不需要任何凭据。

X-API-Key: YOUR_KEY_HERE

Authorization: Bearer 是等效的替代写法：

Authorization: Bearer YOUR_KEY_HERE

密钥格式

密钥由 zn_ 加上 48 位随机字符组成，共 51 个字符。生成后控制台只保留脱敏前缀（形如 zn_xxxxxxxxx…****），用于区分不同密钥。

此前签发的 ck_ 前缀密钥依然有效，无需做任何迁移。

GET /v1/api-key

返回账号上最近签发的启用密钥的编号、脱敏前缀、最近使用时间与创建时间 —— 它报的是一把密钥，不是一份清单。完整响应见账户与余额，一个账号能同时持有多少把密钥见安全。