Toonflow 视频生成 API 接入参数怎么配置，鉴权、回调地址、时长和分辨率该按什么顺序填？

Toonflow 视频生成 API 的接入参数要按鉴权、请求、生成控制、任务交付四层分别配置，任一层缺失都会在联调阶段直接返回参数错误；只在素材已是公网可访问直链、且仅做出片验证时，才可以用最短时长加最低分辨率跑通最小链路，私有素材、批量生产和长时长成片都不适用这套最小配置。字段名与取值范围以官方文档和控制台为准，不同版本可能调整命名。 鉴权参数只放在服务端，不要下放给前端页面、小程序或移动客户端。密钥与租户标识一般放在请求头，塞进 URL 查询串会被网关日志、浏览器历史和链路监控留痕，一旦泄露等于把账号配额交给别人；同一套代码还要区分测试密钥与生产密钥，压测和回归只打测试密钥，避免验证流量挤占生产配额。 请求体里必须显式填写的是模型标识和提示词，其余控制项应走各自字段，而不是写进提示词。把“时长三秒、竖屏、不要水印”这类工程要求混进提示词，模型可能理解成画面内容，出片效果与参数预期完全对不上；正确做法是提示词只描述画面、动作、镜头与风格，时长、比例、水印由独立参数控制。 素材参数最常见的故障是地址取不到。首帧图、参考图这类输入通常要求公网可访问的直链，带签名的临时链接有效期必须覆盖排队加生成的全过程，否则任务开始时链接已失效；本地文件要先上传换成文件标识再引用，内网地址、需登录才能打开的链接、开了防盗链的图床，都会让服务端取图失败。 生成控制参数建议按固定顺序确定：先定画面比例，再定分辨率，然后定时长，最后调运动强度与随机种子。比例与分辨率同时给且互相矛盾时，多数接口会判为参数冲突或按分辨率强制裁剪，先定比例能少一轮返工；随机种子只在同模型同版本下具备复现意义，模型版本一变，旧种子不保证输出一致。 运动强度、镜头控制、风格模板与水印开关属于效果微调项，默认值就能正常出片，只有在批量生产时才需要显式固定。批量场景应把这些值和模型版本一起写进配置文件并做版本记录，否则同一批素材隔天重跑会出现风格漂移，排查时无法区分是模型更新还是参数被改；对画质有硬要求时，水印开关需要和商务授权一起确认，不能只靠传参关闭。 任务交付方式只有回调通知与任务标识轮询两种，二者选一即可，同时使用会带来重复处理。回调地址必须是公网可访问的 https 接口，接收端要做签名校验和幂等落库，同一个任务标识重复推送只处理一次；纯内网系统没有公网入口时只能用轮询，不要为了一次联调临时开穿透端口，那会留下长期暴露面。 轮询要带退避策略，而不是固定间隔高频请求。视频生成属于排队型任务，提交后最初几秒基本拿不到结果，间隔由短到长递增并设置总超时上限，既能保证时效又能省下调用配额；总超时时间要覆盖高峰时段的排队时长，否则会把仍在生成的任务误判为失败，进而触发重复提交和重复扣费。 错误处理要按状态码分流，参数类错误改配置重试没有意义，限流与服务端错误才值得退避重试。提交任务时带一个业务侧生成的幂等键，可以在网络超时、客户端自动重发的情况下避免同一段视频被计费两次；日志里至少记录请求标识、任务标识、各阶段耗时和错误码，缺了这几项，线上问题只能靠猜。 计费和并发配额要按任务粒度核算，不要按调用次数简单估算。视频类接口通常按生成时长或成功任务计量，失败任务是否计费取决于返回状态与官方说明，联调前务必确认；并发上限约束的是同时在跑的任务数，不是每秒请求数，压测与批量补量要和生产高峰错开排期，否则正常业务会被迫排队。 联调顺序建议从最小可用配置起步，再逐项放开。先用最短时长、最低分辨率、单张参考图跑通“提交、回调或轮询、取回结果”整条链路，确认鉴权、素材和结果存储都通，再放开时长、分辨率与并发；每增加一个参数就跑一次固定种子的回归，出问题时能立刻定位到具体是哪一项引起的偏差。 上线前最后核对四件事：画面比例与分辨率是否冲突、回调是否验签且幂等、素材链接有效期是否覆盖任务全程、时长与并发是否在账号配额之内。这四项在联调阶段往往不报错，却容易在高峰期集中暴露；把它们固化成上线检查清单，比上线后翻日志回滚要省时间得多。