视频生成与异步任务
从文生视频、首尾帧与参考素材到时长、声音和任务查询，避免把等待或网络重试变成重复付费生成。
更新日期
开始之前
- 已注册并登录自己的 LINK42 账户；控制台操作使用登录会话，API 调用使用本站 API 密钥。
- 生成会按实际用量扣费。先确认余额、模型可用状态与预估费用；截图只用于说明操作，不代表模型已开通，也不代表生成结果。
准备视频生成
选模型和创作模式
在视频模式选模型，按其能力选择文生视频、首帧/首尾帧、参考生成、编辑或延长。没有开放的模式不会因上传成功自动可用。
组织提示词和素材
描述镜头、主体、动作与氛围。给首帧、尾帧或参考素材正确角色，不把首帧图片当成视频引用。
选择参数并确认费用
核对视频比例、分辨率、按秒/智能时长、声音与数量。不同模型支持不同组合；只有实际返回用量才能确定最终费用。
提交并保留任务 ID
创建后记录返回的 id。随后轮询或打开任务列表等待，不重复 POST 创建同一个视频。
查看清晰原图视频参数与输入限制
比例、480P/720P/1080P、MP4/MOV、智能时长、输出声音和批量数量都按模型能力展示，不是一张通用参数表。模型没有 MOV 或智能时长能力时，不能照搬其他平台界面参数。首尾帧与参考视频/音频的数量、格式、时长和总请求限制同样按选定型号校验。
查看清晰原图等待、取消与恢复
| 状态 | 含义 | 正确操作 |
|---|---|---|
| local_queued / queued | 平台或上游排队 | 继续查同一任务 ID；不要重复创建。 |
| unknown | 上游提交待核对，预扣仍保留 | 保留原任务 ID，稍后查看状态；不要重复创建或取消。 |
| running | 上游正在处理 | 耗时不等于失败；界面计时不是确定完成进度。 |
| succeeded | 模型完成 | 还要检查结果链接和存储状态，再下载并核对实扣。 |
| failed / cancelled / timeout | 任务终态或超时 | 看错误详情与账单；本地等待超时不等于上游已取消。 |
避免重复付费
SDK 创建视频自动携带幂等键，也可给同一业务请求设置稳定键。未知网络结果时，先保存键与任务 ID，再按同一请求内容恢复；不要换新键。取消本地等待不会取消上游，取消任务需要显式操作且以服务端返回状态为准；已经执行的部分费用以账本结算为准。