将集成从 v1 移至 v2
V1 仍然可用。准备好后使用相同的密钥和信用余额迁移各个集成。 V2 是不同的请求和响应合约,因此仅更改 URL 是不够的。
| V1概念 | V2 等效 |
|---|---|
| 单独的姓名、电子邮件和用户名端点 | POST /api/v2/gender 与 type 和 value |
| 分离多个端点 | POST /api/v2/gender/batch 与 items |
| askToAI | options.ai_mode: fallback;单个请求已默认为 fallback |
| forceToGenderize | 所有三种类型的可选字段相同;首先是数据集,然后是昵称感知人工智能 |
| 平坦响应字段 | data 为结果; meta 用于访问和计费 |
| probability 百分比 | confidence(0-1 等级)加上 confidence_kind; AI 分数不是校准概率 |
| total_names | data.sample_count,可为空 |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| 旧版错误格式 | HTTP 状态加上 Problem Details code 和 action |
| POST 重试 | 每次重试都是一次新操作,计费正常 |
更新并验证您的客户端
对您要迁移的集成使用 v2 请求和响应协定。验证 meta.access.mode、保留 JSON null 结果、检查每个项目的批次错误并在重试之前检查计费。将 v1 集成保留在现有路径上,直到更新客户端为止。