ID Photo API AI 是一项面向开发者的证件照生成接口服务,核心能力是通过一次 API 调用,将普通人像照片转换为符合护照、签证、身份证等文档要求的规格照片。
主要能力
- 照片处理流水线:自动进行人脸对齐与裁剪,按照输出尺寸、头部大小和眼线要求调整面部位置;处理背景,替换原始背景同时保留头发、衣物和面部细节周围的自然边缘;执行照片质量检查,识别头部倾斜或转向、光照不均、亮度或清晰度不足、佩戴眼镜以及非中性表情等常见问题。质量检查覆盖头部姿态、光照与清晰度、眼镜与表情。
- 灵活交付:最终图像可以通过 API 响应返回、通过临时 URL 获取,或以可打印排版形式交付。
- 文档规格:一个 API 支持 150 多种照片规格,涵盖世界多国和地区的护照、签证、身份证、驾照和申请照片。在 POST /v2/makeIdPhoto 中通过 specCode 字段指定文档类型。常见格式包括美国护照照片、英国护照照片、中国签证照片、申根签证照片,以及加拿大、澳大利亚、日本、印度、新加坡、新西兰、巴西、韩国等国的护照和签证照片。规格数据可通过 API 查询,产品可动态展示支持的文档类型。若所需格式未列出,可联系创建自定义照片规格。
使用方式
- 集成路径:单一端点完成整个照片工作流。发送人像照片和文档规格,接收裁剪、处理和尺寸正确的照片。认证、参数、问题代码和完整响应模式在 API 文档中维护。
- 账户与凭证:在 IDPhoto.ai Dashboard 中创建或访问账户,API 凭证和账户用量单独管理。可在 Dashboard 中创建账户查看试用权限和账户配额。
- 输出与存储选项:可选择 Base64 交付,不在服务端存储照片;或使用临时 AWS S3 URL 交付,文档说明保留时间从 2 小时到 14 天。支持美国或欧盟 API 端点,其他区域部署可按需申请。数据传输加密,文档化实践涵盖 GDPR 和 CCPA 要求。
适用场景
- 护照和签证照片应用:面向消费者的照片产品,支持直接生成或带水印预览工作流。
- 旅行和签证平台:帮助客户准备正确尺寸的照片,并在提交前识别常见照片质量问题。
- 照相馆和零售商:规模化自动处理背景、裁剪、尺寸调整和可打印照片表生成。
- 人力资源与身份系统:在入职、目录和访问管理工作流中统一员工徽章和头像照片。
配套服务 IDPhoto.ai 还提供聚焦的 API 和服务:批量证件照生成、英国护照照片代码 API、背景移除 API、照片增强 API、徽章照片 API、实时生物特征验证 API、人脸分析 API、护照照片打印与邮寄 API、证件照匹配验证 API,以及团队、活动和头像照片的独特定制 AI 或风格化人像生成。
限制与说明 API 按照所选规格格式化照片并报告可检测的质量问题,最终是否接受由相关政府机构、申请平台或审核机构决定。为获得最佳效果,建议提供清晰、正面、面部和上半身可见的人像,避免强烈阴影、模糊、极端头部角度或面部遮挡。定价取决于使用量和工作流需求,资料未提供具体价格,可通过 Dashboard 试用账户或联系获取批量定价和自定义部署。