平台指南

视频生成

提交文生视频或图生视频任务，轮询状态并下载最终文件。

准备模型与素材

在模型与价格页面筛选“视频”类型，确认模型是否支持文生视频、图生视频、时长和尺寸。图生视频通常需要可公开访问的图片 URL 或按模型要求上传的文件。

浏览视频模型

视频任务是异步的 创建任务成功只代表已受理；必须继续查询状态，直到任务完成或失败。

创建视频任务

视频接口使用任务式流程。请求至少包含 model 和 prompt；image_url、seconds、size 等字段仅在模型目录列出支持时使用。

bash

curl https://api.moloop.io/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "YOUR_VIDEO_MODEL_ID",
    "prompt": "A slow camera move across a quiet mountain lake at dawn",
    "seconds": "5",
    "size": "1280x720"
  }'

如果使用图生视频，把图片输入放入模型要求的 image_url 或文件字段。不要把大文件直接塞进 JSON，除非该模型文档明确要求 Base64。

查询状态与下载

保存创建响应中的任务 ID，按服务端返回的状态间隔查询。常见状态包括 queued、in_progress、completed 和 failed；以实际响应为准。

bash

curl "https://api.moloop.io/v1/videos/YOUR_VIDEO_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 完成后下载视频文件
curl "https://api.moloop.io/v1/videos/YOUR_VIDEO_ID/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output generated-video.mp4

收到 completed 后再请求 content，避免在任务尚未完成时下载。
下载完成后校验 HTTP 状态、Content-Type 和文件大小，再写入对象存储。
failed 时记录错误字段和任务 ID；修正参数后创建新任务。

时长、尺寸与计费

项目	建议
时长	先用短片测试提示词；时长越长通常消耗越高。
尺寸	使用模型支持的横竖屏尺寸，不要只按播放器比例猜测。
并发	为每个账户设置任务上限，并对 429 使用退避。
计费	视频通常按时长、尺寸或每次任务计费，最终以模型目录和日志为准。

失败排查

400：检查模型是否真的支持视频端点，以及 seconds、size 和输入图片格式。
404：确认使用的是创建返回的任务 ID，并且没有重复追加路径。
任务长时间排队：降低并发，记录任务 ID，并查看请求日志中的上游状态。
下载失败：等待 completed 后重试 content，并确认客户端没有把二进制响应当 JSON 解析。