调用Seedance接口返回401、422、429或context deadline exceeded时，要分层来处理：401的话，得去验证并刷新access_token；422呢，需要修正剧本结构；429以及超时的情况，就得改用指数退避与回调机制；要是OAuth不可用，那就启用legacy模式。

调用 Seedance 接口时返回 401、422、429 或 context deadline exceeded，说明鉴权失败、参数校验不通过、触发限流或网络链路异常，必须按错误码分层处理才能恢复服务。

验证并刷新访问令牌

所有接口调用前必须持有有效 access_token，过期（默认 3600 秒）或格式错误的 token 会导致稳定返回 401；OAuth2.1 PKCE 流程中若 code_verifier 未原样传入 token 端点，也会静默失效。

第一步：执行 curl -X POST https://auth.seedance.ai/oauth/token --data 'grant_type=authorization_code&code=YOUR_CODE&redirect_uri=https%3A%2F%2Flocalhost%3A8080%2Fcallback&client_id=YOUR_CLIENT_ID&code_verifier=YOUR_ORIGINAL_VERIFIER' -H "Content-Type: application/json"，注意 【code_verifier 必须是生成时原始未哈希的字符串，不能是 code_challenge】。

第二步：检查响应体中的 expires_in 字段，若小于 60，立即使用新 token 替换旧值；若返回 invalid_grant，说明 code 已被单次消费或超时（10 分钟），需重新走授权 URL 流程。

第三步：将新 token 写入环境变量 export SEEDANCE_TOKEN="eyJhbGciOi..."，后续请求统一读取该变量构造 Authorization 头。

修正导致 422 的剧本结构问题

POST /v2/scripts/parse接口会对输入文本进行严格的语义校验。一旦角色名未在系统中注册，或者时间戳格式出现混乱（比如写成“第1幕”，而不是“[00:00:00]”这种标准格式），又或者动作描述里包含非法控制符（x00-x08），都会触发422 Unprocessable Entity错误。

方法一：用官方 schema 校验器预检
运行 npx @seedance/schema-validator --input script.txt --schema v2.0.7，它会定位到具体行号和字段名，比如提示“line 42: unknown character '王大锤' — register first via /v2/characters”。

方法二：手动剥离干扰项
新建 clean.txt，只保留纯中文对话与标准时间戳标记，删除所有 Markdown 符号、注释括号、英文括号及空行；这一步操作起来很简单，直接把文件拖进去就行。

应对 429 限流与超时叠加问题

当连续轮询 GET /v2/jobs/{job_id} 超过 60 次/分钟，或提交渲染任务后未采用异步模式等待，极易触发 429 并伴随 context deadline exceeded——此时重试只会加剧排队，必须切换策略。

立即停止高频轮询，改用指数退避：首次等待 1s，第二次 2s，第三次 4s，第四次 8s，第五次 16s；累计重试不超过 5 次。

在提交 POST /v2/scenes/render 时，必须在请求体中显式添加 "callback_url": "https://your.domain/webhook" 字段，启用服务端主动回调机制，避免客户端阻塞等待。

若已出现超时堆积，运行 seedancectl cancel --job-id JOB_XXXXX 强制终止卡住的任务，再以 --priority=high 参数重提，高优队列响应延迟低于 800ms。

绕过 OAuth 中心不可用的登录故障

当点击微信/飞书等第三方登录按钮后页面空白或返回 503 Service Una vailable，基本可判定 auth.seedance.ai 服务离线，此时常规 token 获取流程完全中断。

在登录 URL 末尾强制添加 ?mode=legacy 参数，例如 https://app.seedance.ai/login?mode=legacy，将跳过 OAuth 流程，进入本地账号密码直连模式。

清除浏览器 LocalStorage 中所有以 "seedance-auth-" 开头的键值对，然后硬刷新页面；【不清理会导致 legacy 模式仍尝试加载失效的 JWT 缓存】。