Cleer
申请接入

错误码

统一错误体 {"error": {"code", "message"}},响应带 X-Request-Id。限流三层(请求频率 / 并发分析 / 机构配额),超出返回 429 与 Retry-After。

HTTPcode处理
400invalid_request检查参数 Schema
401invalid_credentials / token_expired检查凭证 / 重新取 Token
403scope_denied / entitlement_suspended联系运营开通
404not_found / algorithm_not_foundID 不存在或未开放
409idempotency_conflict / interaction_conflict / run_not_terminal按语义处理
410download_expired / cursor_expired重新获取
413file_too_large改用分片直传
422input_validation_failed / asset_integrity_mismatch校验文件类型/大小/摘要
429rate_limited按 Retry-After 退避
503service_unavailable退避重试