02

認證

Bearer API key。key 屬於你的帳號,可設花費上限,且只以雜湊儲存。

API keys

key 格式為 sk-nxio-v1- 加 48 個十六進位字元,放在 Authorization header 作為 Bearer token。NXIO 只儲存 SHA-256 雜湊,建立後無法再取回。

在 Dashboard → API keys 建立、停用、撤銷。停用的 key 立即回 401;撤銷不可逆。

header
Authorization: Bearer sk-nxio-v1-4e672226fbe2…

每把 key 的花費上限

每把 key 可設美元上限,重置週期為不重置、每日、每週或每月(UTC)。當請求的預估費用會超過剩餘上限時回 402,limit_source = nxio_key_limit。用 GET /key 查剩餘額度。

GET /key
curl https://api.nxioai.com/api/v1/key -H "Authorization: Bearer $NXIO_API_KEY"
# {"data":{"label":"sk-nxio-v1-4e67...5805","limit":null,"limit_reset":null,"usage":0.0123,"usage_period":0.0123,"limit_remaining":null,"is_free_tier":false,"rate_limit":null}}

選用的歸因 header

X-Title(或 X-NXIO-Title)標示你的應用程式名稱,HTTP-Referer 記錄其 URL。兩者會出現在用量分析,方便拆分各應用的花費,且不會轉送給模型供應商。