{"info":{"title":"Seedance 2.5 Video to Video","version":"1.0.0"},"openapi":"3.1.0","components":{"schemas":{"Input":{"type":"object","title":"Input","required":["prompt","reference_videos"],"properties":{"prompt":{"type":"string","title":"Prompt","x-order":0,"description":"Describe the result you want and what to take from each reference. Address the reference assets positionally as @Video1..@Video10, @Image1..@Image30 and @Audio1..@Audio10, numbered by their order in reference_videos, reference_images and reference_audios: with one source clip and one product photo, 'Match the camera movement and pacing of @Video1, but restage it on a sunlit desert roadside at midday; the rider pulls up on the motorcycle from @Image1' borrows the motion from the clip and the subject from the image. A reference the prompt never names is usually ignored, so name every one you send."},"duration":{"type":"integer","oneOf":[{"const":-1},{"maximum":30,"minimum":4}],"title":"Duration","default":-1,"x-order":5,"description":"Length of the generated clip in seconds, from 4 to 30. Leave at -1 (the default) to let the model choose a whole-second length close to the source footage. Billing counts this alongside the duration of the source clips you send."},"resolution":{"allOf":[{"$ref":"#/components/schemas/resolution"}],"title":"resolution","default":"720p","x-order":3,"description":"Output resolution of the clip. 720p meters more tokens per second of video than 480p, so it costs more."},"aspect_ratio":{"allOf":[{"$ref":"#/components/schemas/aspect_ratio"}],"title":"aspect_ratio","default":"16:9","x-order":4,"description":"Frame shape of the generated clip. The source footage does not dictate the framing on this variant, so pick the shape you want - a 1280x720 (16:9) source asked for 9:16 came back as a 480x854 portrait clip. Use adaptive to keep the source's own shape instead."},"generate_audio":{"type":"boolean","title":"Generate Audio","default":true,"x-order":6,"description":"Generate a synchronized soundtrack (dialogue, ambience and sound effects) together with the picture. Set false for a silent clip; the price is the same either way."},"reference_audios":{"type":"array","items":{"type":"string","format":"uri"},"title":"Reference Audios","x-order":7,"maxItems":10,"description":"Experimental: up to 10 short audio references for the generated soundtrack, addressed as @Audio1, @Audio2 and so on. Each clip 2-30 seconds, 30 seconds combined at most; WAV or MP3, under 15 MB each. The clips are accepted and add nothing to the price, but their effect on the finished soundtrack has not been verified - treat the field as experimental. They cannot be sent on their own: at least one reference video is always required."},"reference_images":{"type":"array","items":{"type":"string","format":"uri"},"title":"Reference Images","x-order":2,"maxItems":30,"description":"Optional: up to 30 reference images that steer identity, wardrobe, product, location or style alongside the source footage. Addressed as @Image1, @Image2 and so on, numbered by their order in this array. JPEG, PNG, WebP, BMP, TIFF or GIF; 300-6000 px on a side, aspect ratio between 1:2.5 and 2.5:1, under 30 MB each. A still image has no duration, so reference images add nothing to the price."},"reference_videos":{"type":"array","items":{"type":"string","format":"uri"},"title":"Reference Videos","x-order":1,"maxItems":10,"minItems":1,"description":"1 to 10 source clips - the footage this generation is built from, and where its motion, camera movement and pacing come from. The first entry is @Video1 in the prompt, the second @Video2, and so on. MP4 or MOV (H.264/H.265 video, AAC or MP3 audio), 2-30 seconds per file and no more than 30 seconds COMBINED across all files, 300-6000 px per side, aspect ratio between 0.4 and 2.5, 24-60 fps, under 200 MB each. Billing counts the duration of everything you send here as well as the length of the clip you get back, so a 30-second source costs about as much again as a 30-second output - trim each clip to the part that matters."}}},"Output":{"type":"string","title":"Output","format":"uri","description":"URL of the generated MP4 video clip."},"resolution":{"enum":["480p","720p"],"type":"string","title":"resolution","description":"An enumeration."},"aspect_ratio":{"enum":["16:9","4:3","1:1","3:4","9:16","21:9","adaptive"],"type":"string","title":"aspect_ratio","description":"An enumeration."}}}}