从哪里获取 API 密钥以及保管注意事项
取钥路径
官方 FAQ 的指引只有一句:登录后在用户中心可以看到 API 用法。实操路径:
- 网页端登录(没有账号先注册,邮箱即可);
- 打开用户面板的账户信息 / API 标签;
- 页面上直接展示你的 API 密钥与接口用法(含可切换的 cURL / Python 示例代码)。
密钥怎么用
所有接口调用在 HTTP 请求头里带上:
X-API-KEY: 你的密钥
官方示例中该头出现在上传申请与任务创建等写操作上;查询与重试接口按官方示例代码同样携带此头,保持统一即可。
密钥等于账户操作权
想清楚一件事:拿着你的密钥就能以你的账户身份提交放大任务、消耗你的额度。保管要点:
- 不进代码仓库——密钥不写死在代码里,用环境变量或配置文件(并把配置文件加进忽略清单);
- 不进前端——网页/小程序前端代码是公开的,密钥只放服务端;
- 按需分发——团队共用时谁在用、用多少要登记,额度异常时好排查;
- 疑似泄露就换——官方页面未公开自助重置入口,发现异常消耗立即通过反馈渠道处理并检查账户。
没有密钥会怎样
请求会被拒绝,拿不到上传地址也建不了任务。常见报错排查:头名拼错(X-API-KEY 是连字符大写)、密钥带了引号或空格、账户未登录就抄了旧密钥。
密钥与套餐的关系
API 能力对登录用户开放,但提交的任务消耗的是账户额度——免费账户 20 张/月、付费账户按套餐。接口侧的倍数限制与网页端一致(8x/16x 需付费权限),见免费与付费差异表。