鉴权
API 密钥的创建、使用与安全实践。
所有请求用 Bearer 方式带上你的 API 密钥(sk-jf-live- 开头):
示例中的 sk-jf-live-YOUR_KEY 是占位符,替换成你在控制台创建的真实密钥。
创建 / 管理密钥
在 控制台 → API 密钥 页:
- 创建:可设有效期(永不 / 7 / 30 / 90 天)与额度上限(不限 / 10 / 50 / 100 积分)。
- show-once:完整密钥只在创建时显示一次,之后列表只显示掩码(
sk-jf-live-…后4位)。没存好只能删了重建。 - 删除:软删,不可恢复。吊销密钥就删掉它、再新建一把。
安全实践
- 不要把密钥写进前端代码、公开仓库或截图里。
- 给不同用途建不同密钥,配上有效期与额度上限,把泄露损失框住。
- 怀疑泄露:立即删除该密钥(软删、不可恢复),再新建一把。
额度与计费
调用消耗你账户的积分(与网页端同一钱包)。余额不足时返回 402(见 错误码)。