bigjpg 中文文档 下载 App

从哪里获取 API 密钥以及保管注意事项

取钥路径

官方 FAQ 的指引只有一句:登录后在用户中心可以看到 API 用法。实操路径:

  1. 网页端登录(没有账号先注册,邮箱即可);
  2. 打开用户面板的账户信息 / API 标签;
  3. 页面上直接展示你的 API 密钥与接口用法(含可切换的 cURL / Python 示例代码)。

密钥怎么用

所有接口调用在 HTTP 请求头里带上:

X-API-KEY: 你的密钥

官方示例中该头出现在上传申请与任务创建等写操作上;查询与重试接口按官方示例代码同样携带此头,保持统一即可。

密钥等于账户操作权

想清楚一件事:拿着你的密钥就能以你的账户身份提交放大任务、消耗你的额度。保管要点:

没有密钥会怎样

请求会被拒绝,拿不到上传地址也建不了任务。常见报错排查:头名拼错(X-API-KEY 是连字符大写)、密钥带了引号或空格、账户未登录就抄了旧密钥。

密钥与套餐的关系

API 能力对登录用户开放,但提交的任务消耗的是账户额度——免费账户 20 张/月、付费账户按套餐。接口侧的倍数限制与网页端一致(8x/16x 需付费权限),见免费与付费差异表。

相关阅读:API 接口全景、上传原图。