Skip to content

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-videoprompt、duration、quality、aspect_ratio
image-to-videoimage_url、prompt、duration、quality
transitionfirst_frame_image_url、last_frame_image_url、prompt、duration、quality
reference-to-videoimage_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-extendvideo_url、prompt、duration(要添加的秒数)和 quality。兼容接口 pixverse-v6/extend 使用 taskId 代替 video_url,且任务须由同一 API Key 创建并已成功生成视频。
pixverse-expandvideo_url、quality、aspect_ratio
pixverse-upscalevideo_url
pixverse-restylevideo_url;restyle_id 或 prompt 二选一
pixverse-lipsyncvideo_url;提供 audio_url,或同时提供 tts_text 和 speaker_id
pixverse-avatarimage_url、quality;提供 audio_url,或同时提供 tts_text 和 speaker_id
pixverse-select-maskvideo_url,可选 keyframe_id。结果中的 mask_ref 仅限当前账户使用,有效期 30 分钟
pixverse-swap使用遮罩结果中的 mask_ref、替换图的 image_url 和 quality;无需重新提交视频
pixverse-mimic参考动作的 video_url、目标人物的 image_url、quality
pixverse-sound-effectvideo_url,可加 prompt 和 original_sound_switch;结果是包含音轨的视频
pixverse-image-templatetemplate_id 和按模板要求排序的 image_urls;结果为图片
pixverse-vibemvaudio_url、quality、aspect_ratio;可加参考图 image_urls
json
{
  "model": "pixverse-c1/text-to-video",
  "input": {
    "prompt": "薄雾从晨光照亮的松林中缓缓升起,镜头向前推进",
    "duration": 5,
    "quality": "720p",
    "aspect_ratio": "16:9"
  }
}

ModelFold — 一个 API,接入所有主流 AI 模型。