模型 API视频生成
普通文生与图生视频
从服务发现开始,选择当前模型支持的模式、画幅、时长和分辨率,再创建异步任务。
本页针对普通视频生成服务,不适用于 H3、Wan 角色动画、口型同步或视频超分。先按 快速开始 设置 JUSP_BASE_URL、JUSP_API_KEY、JUSP_MODEL,再读取 服务能力。
选择模式与输入
t2v 使用提示词;i2v 还需要一张首图。图生模式先通过 输入素材上传 的 image 字段上传图片,保存 asset.assetId。清晰度、画幅、时长和模式必须是当前服务开放的组合;下面的 480p、横屏、5 秒仅适用于支持该组合的服务。
{"model":"<MODEL_ALIAS>","generationMode":"t2v","prompt":"海边日落,固定镜头,海浪缓慢向岸边推进","resolutionTier":"480p","orientation":"landscape","seconds":5,"seed":42}图生视频请求:
{"model":"<MODEL_ALIAS>","generationMode":"i2v","prompt":"保持首图主体,镜头缓慢推进","input_image_asset_id":"<IMAGE_ASSET_ID>","resolutionTier":"480p","orientation":"landscape","seconds":5,"seed":42}enableRife 只在普通 Wan 服务明确支持插帧时传入。不应因其他视频模型接受某字段,就向当前模型传递同一字段。不要自行传入内部步数、任意 FPS 或执行批大小。
提交并完成任务
将一个完整 JSON 保存为 request.json,替换模型别名和素材 ID:
curl --fail-with-body --max-time 60 "$JUSP_BASE_URL/media/generations" \
-H "Authorization: Bearer $JUSP_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: video-shot-001' \
--data-binary @request.json --output create.jsonHTTP 202 仅表示受理。按 等待任务并下载结果 查询原 jobUrl,成功后下载 outputs[];按响应 mimeType 保存文件。失败或本地等待超时不会自动创建替代任务。
参数失败时怎样恢复
400 表示模式、素材或规格不合法,先修正请求;401/403 检查 Key 和服务范围;429 按 Retry-After 等待。修改正文是新的业务请求,不得在原幂等键下换参数。价格依据当前服务的基础单价、计费单位及规格,不用任务执行耗时估算生成费用。