鉴权失败必须按签名生成、时间戳、密钥、区域配置四环节顺序排查：先确认AK/SK有效且无空格，再校准GMT时间戳（精确到秒、偏差≤15分钟），接着严格按步骤计算签名并检查Authorization头格式，最后验证Endpoint正确性及网络连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用火山引擎Seedance API时遇到鉴权失败（如SignatureDoesNotMatch、401 Unauthorized、InvalidAccessKey等错误），不是改个参数就能解决的，必须按顺序排查签名生成、时间戳、密钥、区域配置四个硬性环节。漏掉任意一环，请求永远卡在握手阶段。
确认AccessKey与SecretKey有效性
登录火山方舟控制台→进入「密钥管理」页面→核对当前使用的AccessKey是否处于「启用」状态。已禁用或过期的AK会直接触发401错误，且不返回具体原因。
点击对应AK右侧的「查看SecretKey」，【SecretKey仅在创建时显示一次，关闭页面即永久不可见】。若已丢失，必须删除旧AK并新建——重置操作不可逆，旧Key所有历史调用权限立即失效。
复制AK和SK时，注意两端是否混入不可见空格或换行符。建议粘贴到记事本中再手动删掉首尾空白，再填入代码或curl命令。
校准GMT时间戳（最关键一步）
火山引擎签名强制要求X-Date头使用精确到秒的GMT时间，格式为YYYYMMDD'T'HHMMSS'Z'。本地系统时区≠GMT，Android/Windows/macOS默认都不满足。
方法一（推荐，Python）：用datetime.utcnow().strftime("%Y%m%dT%H%M%SZ")生成，严禁用time.strftime("%Y%m%dT%H%M%SZ", time.localtime())。
方法二（curl调试）：执行date -u +"%Y%m%dT%H%M%SZ"获取当前GMT时间串，手动拼入Header。若返回SignatureDoesNotMatch，先检查这串时间与服务器时间偏差是否超过15分钟——偏差超限即拒签，服务端不提示具体偏差值。
【Android开发特别注意】SimpleDateFormat默认用本地时区，必须显式设置.setTimeZone(TimeZone.getTimeZone("GMT"))，否则90%以上首次失败源于此】
验证签名计算全流程
第一步：构造CanonicalRequest。顺序不能错——HTTP方法→URI→Query参数（按字典序排序）→Headers（小写+去空格+分号分隔）→已哈希的body→Header名列表（小写+换行）。漏掉任一换行或大小写错误，签名值全错。
第二步：计算Signature。用SecretKey作为HMAC-SHA256密钥，输入字符串为host + "\n" + X-Date + "\n" + CanonicalRequestHash，输出Base64编码结果。注意：SecretKey需原样参与计算，不可URL编码或UTF-8二次编码。
第三步：组装Authorization Header。格式为HMAC-SHA256 Credential=AK/日期/区域/服务/awsv4_request, SignedHeaders=host;x-date, Signature=xxx。其中区域必须是cn-north-1，服务必须是cv，大小写敏感，缺一不可。
检查Endpoint与网络连通性
确认请求地址为https://visual.volcengineapi.com，不可省略https://，不可替换为volcengine.com或ark.volcengine.com等变体域名。
在终端执行curl -v -X GET "https://visual.volcengineapi.com?Action=DescribeRegions&Version=2022-08-31" -H "Host: visual.volcengineapi.com"，观察是否返回200及Region列表。若超时或Connection refused，说明DNS解析失败或防火墙拦截，需切换网络或配置代理。
国内部分云主机厂商（如阿里云华北1区）存在BGP路由异常，导致对visual.volcengineapi.com的TCP三次握手成功率低于60%。此时应改用聚合平台提供的稳定中转Endpoint，或联系火山引擎技术支持报备IP段。
快速定位错误类型的三步响应分析
① 返回401且Header含X-Amz-Id-2字段：密钥无效或AK被禁用，跳回第一个
重查。
② 返回403且Body含SignatureDoesNotMatch：时间戳偏差或签名计算错误，重点重跑第二个
和第三个。
③ 返回400且Body含InvalidParameter或MissingParameter：请求结构非法，检查Action、Version、req_key等必填Query或Body字段是否拼写正确、是否缺失、是否多加了引号或逗号。
