调用seedance接口返回401、422、429或context deadline exceeded时，需分层处理：401需验证并刷新access_token；422需修正剧本结构；429及超时需改用指数退避与回调机制；oauth不可用时启用legacy模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用 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 Unavailable，基本可判定 auth.seedance.ai 服务离线，此时常规 token 获取流程完全中断。
在登录 URL 末尾强制添加 ?mode=legacy 参数，例如 https://app.seedance.ai/login?mode=legacy，将跳过 OAuth 流程，进入本地账号密码直连模式。
清除浏览器 LocalStorage 中所有以 "seedance-auth-" 开头的键值对，然后硬刷新页面；【不清理会导致 legacy 模式仍尝试加载失效的 JWT 缓存】。
