开放 API:对接前要准备的清单
密钥、权限、计费与任务轮询;适合技术对接同学的开工检查表。
密钥、权限、计费与任务轮询;适合技术对接同学的开工检查表。
写给要接系统的人 开放 API 页解决的是「把奇讯 AI 能力嵌进你们自己的业务系统」。它不是又一个 Generative 玩具页。开工前把下面清单勾完,再写代码,能少打两天日志。 对接前检查表 1. 账号与权限:是否已开通 API / 密钥;密钥是否只放服务端,绝不进前端仓库。 2. 计费:调用与页面任务一样走算力;先用小流量试连通,再放开量。 3. 同步 vs 异步:抠图类可能较快返回;视频/数字人类通常要按任务号轮询——逻辑对齐「任务中心」。 4. 素材:公网可访问 URL 或按文档上传;注意版权与隐私。 5. 失败重试:幂等键、退避重试、不要疯狂连打同一昂贵视频接口。 6. 安全:回调验签、IP 限制、日志脱敏(别把用户人脸 URL 打进公开日志)。 推荐联调顺序 健康检查 → 余额/算力查询(若有)→ 低价图像接口 → 再视频类。 每一档都先在页面手动跑通一次,建立「正确成片长什么样」的参照,再对 API 结果。 和页面的关系 页面是产品能力的「可视说明书」;API 是同一能力的「机器入口」。学院教程里的素材规范、授权要求,API 调用同样适用——合规不会因为走 API 就消失。 具体字段与示例以开放 API 页当前文档为准,本文只固定「开工方法论」。