技术博客 / 接入与实践
视频生成参数怎么填：时长、画幅与参考图核对清单
视频请求最容易出错的地方，是把不同接口的参数拼在一起。先确定当前使用 video-v1，再填写它接受的时长、尺寸和素材。本文说明适配器配置，不承诺所有上游模型都具备相同功能。
时长和尺寸有哪些约束？
| 项目 | 已核实配置 |
|---|---|
| 模型 ID | video-v1 |
| 创建任务 | POST /v1/videos |
| 查询任务 | GET /v1/videos/{id} |
| 获取结果 | GET /v1/videos/{id}/content |
| 时长参数 | 明确填写 seconds，可选 5、10、15、30 秒 |
| 画面尺寸 | 1280x720（横屏）或 720x1280（竖屏） |
| 计费单位 | 视频秒数；具体单价与分组以模型广场及账户记录为准 |
| 型号说明 | video-v1 是接口标识，当前配置不能据此确认底层国产品牌或版本 |
一个最小创建请求
下面的命令使用已配置的模型 ID 和创建路径。请先设置环境变量 MIGO_API_KEY 并确认费用；执行会提交生成任务，可能扣费。
curl "https://migofastapi.xyz/v1/videos" \
-H "Authorization: Bearer $MIGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "video-v1",
"prompt": "清晨的城市街道，镜头缓慢向前移动，柔和自然光，画面稳定",
"seconds": "5",
"size": "1280x720"
}' seconds 必须明确填写。若同时发送 duration，两者应一致；尺寸与额外画幅字段也不能冲突。首次验证只使用这些基础字段，通过后再增加可选参数。
提示词怎样写得容易验收？
把主体、动作、场景、镜头运动和光线分别写清。例如上面的街道镜头只有一个向前移动动作，适合检查画面稳定性。短片中塞入多次场景切换，会让结果更难定位问题。
先锁定时长、画幅和提示词，只改变一个因素观察结果。不要把随机出现的好结果当作稳定能力，也不要通过无限重试解决提示词不明确的问题。
图生视频需要另外核对什么？
当前适配器支持检查 input_reference 素材字段，允许 JPEG 或 PNG，单张图片上限为 8 MiB；具体上传方式按客户端与接口规范处理。不要把任意外网图片地址当作已经上传的服务端素材地址。
图像尺寸、人物一致性、参考图遵循程度和失败返回，应作为分别测试的项目。参数能通过本地校验，并不等于上游一定能完成生成。即梦视频接口使用自己的请求结构，不应直接复制这里的请求正文。
提交前最后检查
- model、鉴权和地址属于同一服务。
- 时长与尺寸在当前接口允许范围内。
- 账户余额可以覆盖预计视频秒数费用。
- 提交后保存任务 ID，避免因等待焦虑重复创建。