硅基流动发文说明视频生成API的异步流程:提交任务后需轮询状态、及时转存结果
硅基流动官方博客发布集成指南,称视频推理耗时较长,API首次响应只返回requestId,应用需轮询 /video/status检查任务状态,并在状态为Succeed后从临时URL下载视频转存至自有存储。文中给出Wan-AI/Wan2.2-T2V-A14B与Wan-AI/Wan2.2-I2V-A14B两个模型示例及错误码处理建议。
AI解读:硅基流动官方博客发布视频生成API集成指南,明确其采用异步工作流:提交请求后返回requestId,应用需另调状态接口查询,直至任务进入Succeed才能获取结果。
文中列出四个任务状态值InQueue、InProgress、Succeed、Failed,要求应用逻辑使用准确拼写与大小写;成功状态下的视频URL为临时地址,需尽快下载并转入自有对象存储。
指南区分两类错误:只有HTTP 429、503、504 才值得原样重试,400、401、403 需修正请求或权限;任务状态Failed与HTTP报错是不同情况,重提前应先读reason。
文中以Wan-AI/Wan2.2-T2V-A14B和Wan-AI/Wan2.2-I2V-A14B为示例模型,并说明文生视频可选 1280x720、720x1280、960x960尺寸,图生视频按源图比例自动匹配输出分辨率。
上述流程、参数和重试建议均出自硅基流动官方博客,属于厂商集成说明;文章未提供生成速度、成功率或成本方面的公开实测数据。
硅基流动官方博客发布一篇视频生成API集成指南,说明其视频生成采用异步工作流:应用提交生成请求后收到requestId,再通过状态接口轮询,任务成功后从返回的临时URL下载视频并转存。
文章将视频任务与文本生成对比,称视频推理计算量更大、输出文件更大,保持原始HTTP连接等待完成不够可靠,可能遭遇客户端或网关超时、网络中断、排队时间波动和应用重启。
五步流程与四个状态值
博客把集成过程拆为五步:提交生成请求、保存requestId、轮询任务状态、在Succeed时取回视频、将结果存入自有存储。文生视频与图生视频共用 /video/submit提交、/video/status查询,差别在请求体输入。
状态接口使用四个值:InQueue表示排队等待,InProgress表示生成中,Succeed表示结果就绪,Failed表示任务未完成。文章要求应用逻辑使用这些准确拼写和大小写。
- 提交成功后应先保存requestId;文中建议在提交前先建内部任务记录,以降低客户端重试造成重复请求的风险。
- HTTP状态成功不代表生成完成,应用仍需检查任务status字段。
- Succeed时从results.videos[].url读取视频地址;响应还可能带reason、results.timings.inference和results.seed。
轮询节奏与结果存储
文章建议轮询时在检查之间等待,任务未完成就逐步拉长间隔,多个worker同时轮询时加入少量随机延迟,并在Succeed或Failed后停止,同时设置本地最大等待时间。文中强调本地超时只代表当前进程停止等待,不代表服务端任务失败,保留requestId后可让另一worker继续查询。
对于结果存储,博客称返回的视频URL是临时的,应尽快下载并迁入应用控制的存储,数据库中保存对象key而非生成URL。生成成功但存储失败时,可把任务置于storage_pending之类的独立状态以便重试传输。
- 不要在任务仍为InQueue时立即重复提交,否则可能产生重复视频和额外用量。
- 建议保存的元数据包括内部任务ID、requestId、模型ID、提示词或哈希、输出分辨率、seed、状态、失败原因、推理耗时和存储对象key。
- API key不应写入源码、公开仓库、前端包或日志;Base64图片和敏感提示词也不宜进入不受限日志。
模型示例、分辨率与错误处理
文章以Wan-AI/Wan2.2-T2V-A14B作文生视频示例、Wan-AI/Wan2.2-I2V-A14B作图生视频示例,称两者当前可通过硅基流动Serverless使用,并提醒模型可用性可能变化,生产部署前应确认有效模型ID。文生视频尺寸选项为 1280x720、720x1280、960x960;图生视频输出分辨率按源图比例匹配:16:9 为 1280×720,9:16 为 720×1280,1:1 为 960×960。
错误处理上,博客称只有 429、503、504 值得原样重试,且应限制次数、逐步增加延迟;400 为参数无效,401 为密钥无效或缺失,403 为权限不足,500 为意外服务错误。状态Failed则应先读reason再决定是否重提。文章称限流按账户维度施加,不同模型可有不同限制。
- 提示词建议写成一段连贯文字,说明主体、主要动作、事件顺序、环境和镜头运动,控制在 200 词以内。
- seed为可选参数,需要记录生成设置时可与结果一并保存。
- 文中Python示例的轮询参数是应用设置,不是API固定要求;生产Web应用应把轮询放在后台worker中,而非保持浏览器请求连接。
厂商说明的边界
上述流程、状态值、错误码和模型示例均来自硅基流动官方博客,属于厂商对其API用法的说明。文章没有给出生成耗时、任务成功率、并发上限或计费价格的公开数据,因此无法据此判断该服务相较其他方案的实际表现。