如何注册账号？
进入注册页面，填写手机号码、短信验证码和登录密码。注册完成后，使用手机号码和密码登录。
常见问题
查找账号、API Key、接口调用、计费与常见错误的处理方法。
账号与 API Key
如何创建应用并获取 API Key？
登录后进入应用管理，点击“添加应用”，填写应用名称并选择与业务对应的应用权限。创建成功后，应用列表中的 Key 即为调用接口所需的 API Key，点击 Key 可以复制。
API Key 可以放在网页或小程序中吗？
不建议。API Key 属于服务端凭据，应保存在服务端，不要写入浏览器网页、小程序前端代码、公开仓库或日志。前端业务应先请求自己的服务端，再由服务端调用 API。
接口调用
第一次接入应该从哪里开始？
先查看快速开始，完成账号和应用创建，再选择需要的接口。每个接口页面都提供请求参数、返回字段以及 cURL、PHP、Python、Java 和 Node.js 示例。
HTTP 请求成功，为什么业务仍然失败？
HTTP 状态只表示请求已经送达。收到响应后仍需解析 JSON，并检查业务 code 和 msg；只有接口文档规定的成功状态才能继续读取 data。
图片应该怎样提交？
需要上传图片的接口通常使用 Base64 图片内容。请使用原始 Base64 字符串，并交给表单编码器处理特殊字符，不要重复进行 URL 编码。不同接口的图片格式、大小和分辨率限制可能不同，请以对应接口页面为准。
生成的证件照如何排版？
可以前往Demo 下载页面，下载示例源码，参考对应编程语言中的证件照排版代码，将生成的证件照排版到相纸上，用于打印或冲印。
pic_id 可以一直使用吗？
不可以。需要继续美颜、换装或提交回执时，应在对应接口标注的有效期内使用 pic_id。当前相关接口标注的有效期为 50 分钟，超时后请重新调用制作接口。
版本与计费
证件照制作 V3 和 V5 有什么区别？
V3 按接口调用次数计费，制作成功后直接返回无水印图片；V5 先免费生成带水印预览，确认效果后再调用获取接口，成功取得无水印图片时按订单计费。详细对比请查看V3 与 V5 的区别。
调用失败会扣费吗？
不同接口的计费条件并不完全相同。例如部分 V3 接口在检测不通过时仍有检测费用，V5 获取无水印图片成功时才扣费。请在调用前查看对应接口页面的“接口费用”，不要统一按“失败免费”处理。
问题排查
提示 API Key 无效或没有权限怎么办？
请依次确认 Key 是否完整、应用是否启用、应用权限是否包含当前接口，以及请求使用的 Key 是否属于当前账号。可在应用管理中检查应用状态和权限。
接口返回错误时应该提供哪些信息？
请记录请求时间、接口地址、HTTP 状态、业务 code、msg 和用于定位的订单号或 pic_id。联系技术支持时不要发送完整 API Key、用户密码或未经处理的敏感照片。
