PixVerse 视频和图片能力
向 https://modelfold.ai/v1/jobs/createTask 发送 POST 请求,带上 Authorization: Bearer $MODELFOLD_API_KEY 和 Content-Type: application/json。请求体为 { "model": "模型 ID", "input": { ... } }。可以在最外层传入 callBackUrl,或使用返回的任务 ID 查询结果。
视频生成
模型 ID 为 pixverse-<版本>/<模式>。版本为 c1、v5.6、v5.5 或 v5;V5.5 不提供首尾帧模式。可选参数以模型详情页的 API 标签为准,不同版本支持的时长、清晰度和声音选项不同。
| 模式 | 输入 |
|---|---|
text-to-video | prompt、duration、quality、aspect_ratio |
image-to-video | image_url、prompt、duration、quality |
transition | first_frame_image_url、last_frame_image_url、prompt、duration、quality |
reference-to-video | image_references(对象数组,每项含 url,可加 ref_name 和 type)、prompt、duration、quality、aspect_ratio |
素材处理与模板
素材字段使用服务端可访问的 URL。网页试用不支持上传视频或音频时,请从 API 提交。
| 模型 ID | 主要输入 |
|---|---|
pixverse-multi-transition | 按顺序填写 image_urls 和 segment_durations;图片数量比分段时长多 1。选择 quality,可加 motion_mode |
pixverse-extend | video_url、prompt、duration(要添加的秒数)和 quality。兼容接口 pixverse-v6/extend 使用 taskId 代替 video_url,且任务须由同一 API Key 创建并已成功生成视频。 |
pixverse-expand | video_url、quality、aspect_ratio |
pixverse-upscale | video_url |
pixverse-restyle | video_url;restyle_id 或 prompt 二选一 |
pixverse-lipsync | video_url;提供 audio_url,或同时提供 tts_text 和 speaker_id |
pixverse-avatar | image_url、quality;提供 audio_url,或同时提供 tts_text 和 speaker_id |
pixverse-select-mask | video_url,可选 keyframe_id。结果中的 mask_ref 仅限当前账户使用,有效期 30 分钟 |
pixverse-swap | 使用遮罩结果中的 mask_ref、替换图的 image_url 和 quality;无需重新提交视频 |
pixverse-mimic | 参考动作的 video_url、目标人物的 image_url、quality |
pixverse-sound-effect | video_url,可加 prompt 和 original_sound_switch;结果是包含音轨的视频 |
pixverse-image-template | template_id 和按模板要求排序的 image_urls;结果为图片 |
pixverse-vibemv | audio_url、quality、aspect_ratio;可加参考图 image_urls |
json
{
"model": "pixverse-c1/text-to-video",
"input": {
"prompt": "薄雾从晨光照亮的松林中缓缓升起,镜头向前推进",
"duration": 5,
"quality": "720p",
"aspect_ratio": "16:9"
}
}