开发者
提交客户 API 任务
密钥、幂等性、上限和结果分页。
使用限定权限范围的密钥
生产环境验证请使用具有 submit 权限范围的 Live 密钥。请将其保存在您的服务器上，并仅分配所需的 submit、read 或 balance 权限范围。Test 密钥会模拟保留的示例地址，不会调用服务提供商，也不消耗额度。
正式密钥上限按已扣除额度加已受理的预留额度计算。达到上限后，新任务将被拒绝，且不会创建预留。工作区额度会在检查被接收处理时进行预留，扣除和退回规则与控制台一致。
安全重试
提交任务时请附带固定的 Idempotency-Key。匹配的重试请求将返回同一任务。使用返回的任务 ID 读取状态和分页结果。重复使用同一幂等键但请求内容不同的请求将被拒绝。
运营暂停可能会临时拒绝新的正式任务，返回 HTTP 503 live_verification_unavailable，且不会预留额度。请稍后使用相同的幂等键重试。这与 API 密钥权限、密钥上限和速率限制无关。