模型 API视频生成
视频超分
上传一个 MP4 视频,选择目标短边,并在异步完成后下载保留音频的输出。
视频超分提升已有视频清晰度,不需要提示词。按 快速开始 配置环境变量,并从 服务发现 选择可用的视频超分模型。
1. 上传源视频
curl --fail-with-body --max-time 120 "$JUSP_BASE_URL/assets/input?model=$JUSP_MODEL" \
-H "Authorization: Bearer $JUSP_API_KEY" \
-F 'video=@source.mp4' --output upload.json只接受一个 video/mp4 文件,通用上传大小上限为 128 MiB;以实时服务约束为准。保存 asset.assetId。不限视频总时长不等于不限上传大小、存储或运行资源。
2. 选择目标规格并创建
当前目标短边包括 480p、720p、1080p、1440p,选择当前服务实际开放的一项。输出保持原画幅;不传 orientation、seconds 或 prompt。平台选择最大的 4n+1 有效帧前缀,例如 150 帧按 149 帧处理,通常无需手工裁剪。
{"model":"<MODEL_ALIAS>","input_video_asset_id":"<VIDEO_ASSET_ID>","resolutionTier":"720p","seed":42}将完整请求保存为 request.json:
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: upscale-video-001' \
--data-binary @request.json --output create.jsonbatch_size=0 和 color_correction=adain 属于当前默认处理配置;调用方不需要添加或自行调优内部执行参数。
3. 等待并读取结果
按 任务查询和下载 查询原 jobUrl,从 outputs[].contentUrl 下载 MP4,输出保留源视频音频。平台不因执行时间较长设置超分任务总时长截止;客户端仍需设置单请求超时和可配置的总等待预算。预算用完只结束本次等待,不取消服务端任务。
错误处理
非 MP4、无法解码、缺少有效帧信息或未开放的短边会被拒绝。429 等可恢复错误按服务端建议退避;任务失败保存 jobId、requestId 和错误码。不要用源视频时长乘一个固定倍数推算运行时间;价格以当前规格和有效帧计量为准。