使用 GenderAPI 在 Airtable 中处理姓名和电子邮箱地址

使用 Airtable 扩展映射字段

GenderAPI 扩展会从您选择的字段中读取姓名或电子邮箱地址，并把性别预测写入单独的目标字段。您还可以映射国家/地区、probability 和识别出的名字，并跳过性别目标字段中已有值的记录。

2026年9月27日审核的扩展代码针对姓名和电子邮箱地址使用 V1 端点及其顶层响应字段。本指南描述的是原生工作流。已安装的扩展可能会独立于本指南发生变化，因此在应用下面的映射之前，请先检查可用的选项。

打开正确的 base，在 Extensions 中添加 GenderAPI.io 并启动扩展。完成扩展显示的连接步骤。
选择要使用其积分的密钥。检查剩余余额，并确认该密钥属于正确的 GenderAPI 账户。
选择包含姓名或电子邮箱地址的表格和源字段。请把原始输入保留在该字段中，并为结果创建单独的字段。
选择必填的性别目标字段以及任何额外的目标字段。如需显示格式化的百分比值，请使用 percent 字段；如需保留 probability 的原始数值范围，请使用数字字段。
决定是否保留已填写的性别目标字段。跳过这些字段的选项也会保留上一次运行留下的未解析文本值。因此，请只清除您有意重新处理的结果。

源字段中可以同时包含姓名和电子邮箱地址。在审核的实现中，包含 @ 的值会走电子邮箱地址路径。这条路由规则并不会核实邮箱是否存在。

扩展设置	是否必填	值与行为
积分密钥	是	所选的 GenderAPI 账户密钥为处理的请求提供积分。
表格和源字段	是	源单元格包含一个姓名或一个电子邮箱地址。空的源单元格会被跳过。
性别目标字段	是	接收原生的 gender 字段。请把未解析的值与 male 和 female 区分开。
国家/地区目标字段	否	接收返回的 country 值。这是一个输出列，而不是请求中的国家/地区筛选。
probability 目标字段	否	接收旧版 API 的 probability 值。percent 字段接收除以 100 之后的值，而数字字段保留原始数值范围。
Found Name 目标字段	否	在有值时接收原生 API 返回的名字。请把这个推断出的候选值与源值分开保存。
跳过已填写的性别字段	否	保留目标字段中已有值的记录，包括未解析的文本。每次运行之前请检查该选项。

请先用一个包含一个姓名、一个电子邮箱地址、一个空单元格和一个含义不明确的输入的小测试表格开始。在处理主表格之前，请检查所选的目标字段，以及 Airtable 如何显示 probability 的数值范围。

在审核的代码中，未解析时的默认值可能显示为文本 null 和 probability 0。某些原生响应失败时也可能留下这些默认值，而连接错误可能会让记录保持不变。请检查运行状态和受影响的行：仅凭文本 null 并不能证明查询成功。

运行后请检查已有的值。请保留未解析的结果以便复核，而不要自行指定性别。基于姓名的预测不能确认一个人的性别认同，返回的国家/地区也不能证明其居住地。

您看到的情况	应采取的操作
预期的列中出现了预期的结果	保留原始输入以及任何额外字段，以便核对映射。
文本 null 或 probability 0	把该情况保留为未解析，并在决定是否重新查询之前检查处理状态。
已填写的目标字段保持不变	检查跳过选项。这种保留可能是有意为之。
出现有关密钥或积分的提示，或者出错后结果保持不变	先解决账户或连接问题，并找出受影响的记录，然后再重新开始。

原生扩展使用所选的 GenderAPI 密钥逐个查询这些值。对未被跳过的相同记录重新运行，可能会发送新的请求并再次消耗积分。Airtable 的方案和扩展的可用性与这一账户余额无关。

原生输出不会显示 V2 响应中的 data/meta、明确的 AI 模式选择、每个条目的 usage 对象或 V2 的批量契约。对于此工作流，请使用 V1 文档；当您需要这些选项时，请使用下方单独的 API 方案。

扩展会把映射的值发送出去进行处理，并把结果写回您的 base。请查看已发布的数据处理政策以及扩展对相关记录的权限，不要在源映射中包含无关的字段。

对于自定义集成，GenderAPI V2 接受姓名、电子邮箱地址和用户名，并返回明确的结果、置信度、来源和用量字段。请单独配置这一连接：阅读 V2 指南并不会改变已安装的应用或其输出列。

Python 和 Node.js 示例涵盖单个请求、批量请求、unknown 结果和运行错误。请先阅读身份验证指南，并在发送计费请求之前选择 AI 模式。

Airtable 扩展使用 GenderAPI V2 吗？

2026年9月27日审核的扩展代码针对姓名和电子邮箱地址使用 V1 端点。自定义的 V2 连接有不同的请求和响应字段，也不会更新已安装的扩展。

一个源字段可以同时包含姓名和电子邮箱地址吗？

可以。审核的扩展会把包含 @ 的非空值发送到电子邮箱地址查询，把其他值发送到姓名查询。这只是输入的路由，并不是对邮箱的核实。

为什么 probability 在百分比字段中显示得不一样？

对于 Airtable 的 percent 字段，扩展会把旧版 API 的 probability 值除以 100，以便 Airtable 以百分比形式显示。数字字段会保留原始数值范围。它不是 V2 的 confidence 字段。

跳过选项会保留未解析的结果吗？

会。当目标字段中已有值时就会保留，包括上一次运行留下的文本 null。请复核这些记录，并只清除您有意重新处理的值。

本指南最近一次审核于 2026年9月29日。请在平台文档中确认安装方式；如需单独构建 V2 集成，请使用下列 API 文档。