{"version":"1","model":{"id":"fal-ai/pixverse/swap","name":"PixVerse Swap","kind":"video","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"PixVerse Swap — replace a person, object, or background in any video by uploading a reference image, with optional original audio preservation.","pricing_note":"$0.15 per clip at 360p/540p or $0.20 at 720p for up to 5 seconds; every tier costs exactly 2× when the source video is longer than 5 seconds.","categories":["v2v"],"prompt_required":false,"prompt_supported":true,"supports":{"startImage":true,"referenceVideo":true},"requires":{"startImage":true,"referenceVideo":true},"aspect_ratios":[],"resolutions":["360p","540p","720p"],"durations":[],"base_credits":25,"api_gross_margin_percent":20,"added_at":"2026-05-30","popularity_rank":344,"example_prompt":"Upload a video and a reference image — PixVerse Swap replaces the target person, object, or background seamlessly","preview":{"video":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/pixverse-swap-official-v1.mp4"},"schema_url":"/api/v1/models?id=fal-ai%2Fpixverse%2Fswap","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixverse%2Fswap","title":"PixVerse Swap generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/pixverse/swap.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/pixverse/swap","description":"ArtEmotion model identifier."},"extra":{"type":"object","additionalProperties":true,"description":"Model-specific settings may also be nested here."},"max_credits":{"type":"number","minimum":1,"description":"Reject before submission if the estimated list price exceeds this cap."},"webhook_url":{"type":"string","format":"uri","maxLength":2048},"webhook_secret":{"type":"string","maxLength":512},"folder_id":{"type":"string"},"prompt":{"type":"string"},"mode":{"title":"Swap Target","description":"Choose whether the replacement image should swap a person, an object, or the video background.","default":"person","type":"string","enum":["person","object","background"]},"keyframe_id":{"title":"Mapping Keyframe","description":"Frame used to map the replacement. PixVerse normalizes the source to 24 FPS, so frame 24 is approximately one second into the video. The maximum is source duration × 24.","default":1,"type":"number","minimum":1,"multipleOf":1},"original_sound_switch":{"title":"Keep Original Sound","description":"Keep the audio track from the source video in the generated result.","default":true,"type":"boolean"},"seed":{"title":"Seed","description":"Optional random seed for a repeatable swap.","type":"integer"},"resolution":{"type":"string","enum":["360p","540p","720p"]},"image_url":{"type":"string","format":"uri"},"video_url":{"type":"string","format":"uri"}},"required":["model_id","image_url","video_url"],"additionalProperties":false},"parameters":[{"key":"mode","label":"Swap Target","type":"select","default":"person","options":["person","object","background"],"description":"Choose whether the replacement image should swap a person, an object, or the video background."},{"key":"keyframe_id","label":"Mapping Keyframe","type":"number","default":1,"min":1,"step":1,"description":"Frame used to map the replacement. PixVerse normalizes the source to 24 FPS, so frame 24 is approximately one second into the video. The maximum is source duration × 24."},{"key":"original_sound_switch","label":"Keep Original Sound","type":"toggle","default":true,"description":"Keep the audio track from the source video in the generated result."},{"key":"seed","label":"Seed","type":"seed","description":"Optional random seed for a repeatable swap."}]}}