Docs

Quick Start

Send JSON with your API key. Use ?sync=1 when you want the final movie_url back in the same response.

curl -sS -X POST 'https://api.jsonclip.com/render?sync=1' \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data @- <<'JSON'
{
  "env": "prod",
  "movie": {
    "format": { "width": 720, "height": 1280, "fps": 30, "background_color": "#000000" },
    "scenes": [
      { "type": "image", "src": "https://cdn.example.com/media/cover.jpg", "duration_ms": 2000, "variable_name": "cover" }
    ],
    "audio": [
      { "src": "https://cdn.example.com/audio/intro.mp3", "role": "music", "from_ms": 0, "to_ms": 2000, "fade_out_ms": 300 }
    ],
    "effects": [{ "type": "zoom_in", "to_ms": 2000, "settings": { "strength": 1.1 } }],
    "captions": { "style": "bold_center" }
  }
}
JSON

Hosted https://api.jsonclip.com/render expects downloadable https://... media URLs in JSON mode. It cannot read your workstation path like /Users/me/file.png or file:///Users/me/file.png. Use optional env: "local" only when you intentionally target self-hosted/local workers that can access those paths.

Asset Source Rules

• Hosted API + JSON body: use downloadable https://... assets for scenes[].src, overlays[].src, audio[].src, and captions.src.
• Hosted API + multipart upload: send files via files[] and reference them by uploaded basename such as look_01.jpg.
• Self-hosted/local renderers may also resolve file://... paths when the renderer process can reach that filesystem.
• When multipart upload is used, basename matching is what matters. ./cover.jpg, /tmp/cover.jpg, and file:///tmp/cover.jpg all resolve to uploaded cover.jpg.

Local Files In One Request

You can upload local media files and render in one call. Send multipart/form-data with files[] and render_config. This is the hosted API flow for assets that only exist on your machine.

DIR=./looks
curl -sS -X POST 'https://api.jsonclip.com/render?sync=1' \
  -H "X-API-Key: YOUR_API_KEY" \
  --form-string "render_config=$(cat <<'JSON'
{
  "env": "prod",
  "movie": {
      "format": { "width": 720, "height": 1280, "fps": 30, "background_color": "#000000" },
      "scenes": [
        { "type": "image", "src": "look_01.jpg", "duration_ms": 1200, "transition_out": { "type": "white_strobe", "duration_ms": 300 } },
        { "type": "image", "src": "look_02.jpg", "duration_ms": 1200, "transition_out": { "type": "glitch", "duration_ms": 260 } },
        { "type": "image", "src": "look_03.jpg", "duration_ms": 1200, "transition_out": { "type": "tremble_shrink", "duration_ms": 320 } },
        { "type": "image", "src": "look_04.jpg", "duration_ms": 1200 }
      ],
      "overlays": [
        {
          "type": "text",
          "text": "SPRING DROP",
          "from_ms": 120,
          "to_ms": 1800,
          "position_px": { "x": 360, "y": 140 },
          "width_px": 560,
          "style": { "font": "Avenir Next", "size_px": 64, "bold": true, "case": "upper", "align": "center", "color": "#ffffff" },
          "stroke": { "color": "#000000", "width_px": 5 }
        }
      ],
      "effects": [
        { "type": "zoom_in", "from_ms": 0, "to_ms": 1800, "settings": { "strength": 1.08 } },
        { "type": "panel_flash_2", "from_ms": 1800, "to_ms": 3600 },
        { "type": "fade_out", "from_ms": 4200, "to_ms": 4800 }
      ]
    }
  }
}
JSON
)" \
  -F "files[]=@$DIR/look_01.jpg" \
  -F "files[]=@$DIR/look_02.jpg" \
  -F "files[]=@$DIR/look_03.jpg" \
  -F "files[]=@$DIR/look_04.jpg"

Every local src inside render_config must match one uploaded file basename. The plain-text docs include a longer 20-image fashion-reel example using the same pattern.

Sync And Result Shape

• POST /render?sync=1 or top-level "sync": true waits for completion and returns final fields like movie_url and duration_ms.
• Without sync, the API can return a queued job response first. Poll the result endpoint if you use async mode.

Common Mistakes

• Using local disk paths against the hosted API without multipart upload.
• Uploading files but referencing a different basename in src.
• Expecting the final video URL without passing ?sync=1 or "sync": true.
• Using transition or effect names that are not in the built-in catalog.
• Mixing JSON-body examples and multipart form examples in the same request.

Active transitions: mix, black_fade, flash, white_strobe, strobe, tremble_shrink, left, left_simple, right, right_simple, down, down_simple, up, up_simple, glitch, snap_back, blur, spin_clockwise, spin_counter_clockwise, superimpose, wipe_left, wipe_right, wipe_up, wipe_down, split_horizontal, split_vertical, slight_jitter, ghost_glow, shake_flash, dynamic_smear, burned_portal, vibrate_amped, quick_dazzle, dazzle_blur, clap_pull, matte_snapshots, snap_away, heatwave_flash, sphere_album, bw_ghost, snapshot_glam, blurry_shock, silky_switch, blur_focus, space_beam, dust_flurry, twist_flash, wavy_surf, snow_cleared, negative_dissolve, red_laser_scan, dof_twirl, seesaw_blur, retro_neon_light, velocity_stretch, 3d_scroll_down, star_screen, cube_folds, contrast_overlay, morning_glare, pull_down, flash_blast, fire_burst, magnetic_slowdown, flashing_down, horizontal_stretch, flashy_spin, stack_rotate, bounce_exchange, paper_skip, blueprint_sketch, cut_flash, shake_snap, phone_camera, shuriken_switch, red_blue_flash, shake_pass, beehive_morph, cyber_flare, dollar_sign, dof_wiggle, elastic_rush, tv_curly_lines, cyborg_blue, punch_zoom, camera_right, green_pulse, blurry_tremble, brushes_in_the_wind, overlap_swipe, night_warp, read_on_phone, ripped_collage, rapid_blinking, cubic_dance, split_off_cube, scene_flash, warp_twist, rainbow_scatter, neon_burn, cross_expand, 3_split_slide, anticlockwise_drag, gum_stretch, pull_snap, dream_light_tilt, block_slides, bw_smear, layer_rotation, shredded_pan, glass_cutting, virtual_notebook, switch_flick, washer_disco, laser_rain, radiant_wipe, lens_up, 3d_card_2, vertical_cutout_1, pull_blur, bubbly_wash, sticky_note, monster_jaws, candy_switch, rotate_fault, window_swap, neon_scuffing, star_slice, film_flipping, particle_blur, semi_reset, halved_scroll, preview_window, nesting_box, ghost_impact, light_graffiti_i, lens_down, zeroing_in, speedy_slots, 3d_rotation, white_strokes, film_negatives, 360_dark, bubble_poof, squishy_cube, slow_down_twirl, zoom_out_carousel, 3d_glass, corner_burn, dotted_bling, tablet_flip, deck_spotlight, pull_reveal, scene_flash_2, layered_glass, flashing_veil, window_swipe, slanted_cutout, film_stains, slight_rotation, winter_star, bizarre_rubik, stretch_morph, flying_card, dealing_cards, hypno_shock, wave_bling, 3_way_split, corner_up, sns_turn, negative_unveil, slide_down, expansion_transition, center_clasp, instant_polaroid, tile_view_swipe, mosaic_slide, pop_up_note, sand_sculpting, fly_away, rubik_dance, detachment, pop_switch, horizontal_cutout, mood_board, shrinking_circle, cut_out_flip, clipping_spiral, snapshot_jumps, train_wipe, omni_expand, box_shut, quartered_lens, vertical_cutout_2, rotation_transition, turning_blocks, lines_morph, hole_spots, multi_tier_feed, negative_fracture, 3_flap_turn, multi_line_slide, light_graffiti, twist_glow, 9_block_swing, sliced_ripple, intrusive_slide, pink_envelope. Active effects: white_flash, shutter_flash, shutter_flash_brightness, black_flash, negative, fade_in, fade_out, film_grain, blur, vignette, vignette_flash, blur_on, blur_off, chalky_doodle, diamond_blur_on, crowded_interview, zoom_in, zoom_out, zoom_in_out, jitter, zoom_top, shake, zoom_bottom, flash_jitter, glitch, zoom_left, colors_on, zoom_right, colors_off, club_mood, club_mood_2, rotate_snap, circle_flash, rotate_circle_flash, move_left, swing, move_right, shaky_highlight, zigzag_view, move_up, move_down, panel_flash, panel_flash_2, frantic_shots, frantic_shots_top, overlay_b_w_vhs, insistent_blur, overlay_bouncing_snow, overlay_buffer_overload, rotate_window, off_color_rotation, overlay_burn_scribble, low_quality, overlay_butterfly_color, overlay_canvas_doodle, popular_post, overlay_chalk_graffiti, tv_on, glowing_drift, overlay_chaos_gallery, old_error_message, overlay_chrome_glitch, laser_showcase, overlay_cold_lab, overlay_crashing_neon, warm_flash, exposure_glow, overlay_crime_of_passion, film_intro, overlay_cross_stitch_dye, overlay_cyberpunk_glitch, pink_alert, laser_fragments, overlay_digital_cam, negative_frequency, overlay_doomsday_glitch, insta_reel, overlay_dramatic_news, overlay_electric_graffiti, sun_flashes, border_scrawl, overlay_falling_petals_2, overlay_fauly_signal, whizz_slide, overlay_film_passion, scorched_hole, overlay_firescape, red_wrapper, glitter_burst_love, overlay_flowers_for_you_2, clover_rotation, overlay_flying_pellets, overlay_fortune_temple, soul_returning, leak_2, overlay_fragmented_glitch, overlay_freezing_winter, vertical_open, intense_flashback, overlay_frosted_player, clone_stretch, overlay_gauzy_illusion, hand_heart, overlay_gift_unwrapping, anime_speed, overlay_gitter_burst_love, heart_reaction, overlay_glitchy_cyberspace, monochrome_clarity, overlay_glitchy_news, garden_frame, overlay_grainy_effect, overlay_grainy_vignette, smooth_popup, overlay_graphic_error, vignette_scanlines, overlay_hardbeat_poof, room_3d, confetti_butterflies, overlay_icebreaking_song, bw_reel_jam, overlay_inflammable, bling_focus, overlay_insta_famous, overlay_katana_slash, reality_breakdown, overlay_kraft_borders, soap_bubble_heart, halo, overlay_led_hardbeat, intense_flickers, overlay_laser_showcase, gauzy_illusion, overlay_liking_post, overlay_magnifying_glass, tempo_zoom, overlay_map_cutout, pixel_hearts, negative_grime, overlay_math_invasion, golden_melody, overlay_matrix_glitches, overlay_molnochromatic_error, screen_damage, overlay_old_dv, tv_issue_overlay, convex_space, overlay_omnious_tv, igi_popup, overlay_open_folder, misalignment, overlay_painted_stars, color_distortion, overlay_petal_puff, hallucination, overlay_phone_clarity, jagged_zoom_out, overlay_phone_to_phone, hollow_masks, overlay_player_3, overlay_polaroid_simulation, vibrant_power, inversion_attack, overlay_pop, bio_horror, overlay_prism_motion, heart_splash, overlay_puzzle_refocus, overlay_question_marks, pastel_distortion, overlay_reel_terror, paper_merging, ice_breaker, overlay_repeated_warning, overlay_rotate_burst, tv_glitch, fast_drops, overlay_runway_blind, crumpled_noir, overlay_seamless_zoom, doodly_album, overlay_select_next, overlay_sharpened_negative, select_next, chaos_gallery, overlay_sinister_inkspread, green_double, overlay_slick_slide, multiplied, overlay_snowfall, anime_flashbang_2, overlay_stagelight_swing, overlay_stanger_storm, woodland_romance, burned_frame, overlay_starshine_city, mono_colors, overlay_stranger_disaster, overlay_tv_frequency, painting, firefly_heart, overlay_target_lens, overlay_tripple_players, upper_lens_glare, overlay_turbulence_echo, watercolor_burn, overlay_twisted_mockery, pool_surface, electronic_halo, overlay_vhs_adjustment, needle_shrink, overlay_vertical_slashes, overlay_video_cam, rusty_brown, overlay_vintage_tv_wall, spinning_blur, overlay_window_shadow, ring_panorama, rippling, chromatic_beats, laser_glitch, stock_info, simple_aberration, detective_folder, paint_carnival, image_stitching, film_burner, warp_spin, upside_down_split, bw_scribbles, somber_glitch, prism_wobble, filmscroll_jam, excited_stars, pulsing_stretch, windmill_tile, parallax_stack, wreath_meltdown, mass_drop, mirror_ripple, shabby_room, dark_plaid, luminal_passing, flip_zoom, ufo_encounter, purple_sparks, neon_motion, film_frame, slow_echo, fairy_hearts, infrared_scan, watery_noise, garland_frame, frame_fireworks, rose_rain, stretch_boxes, polar_sunbeams, pulsing_web, super_bokeh_spot, zoom_lens, diamond_zoom, mini_zoom, halo_blur, the_end, landscape_close, motion_blur, shimmer_360, low_exposure, square_blur, blurry_focus, portrait_open, hazy, to_color, blink, horizontal_close, camera_focus_2, cinema, blurred_love, dynamic_blur, colorize_bw, strong_sharpen, white_out, vertical_close, vertical_blur, four_screens, dual_screens, three_screens, nine_screens, six_screens, cross_split, mirror_flicker, segment_flash, cutout_flash, flashing_shards, speed_cut, cross_pulse, irregular_cuts, staggered_split, rectangle_cut, vertical_cut, rocky_split, five_flash_shots, slices_overheat, box_cut_flash, windmill_pulse, plank_flash, cut_n_paste, vertical_scan, four_panels, scrolling_error, dynamic_shapes, geometric_cutting, shape_cuts, flash_keys, explosion, leak_1, negative_strobe, dance_flash, technical_flash, sunset_1, feverish_imprint, flashlight_focus, dreamy_light, by_the_fireplace, fault_light, ghost_blast, sunset_4, divine_zoom, kinetic_shots, pink_blinkers, beam_shockwave, sonic_ripple, zoom_flash, spark, spotlight_sway, flickering_disco, paparazzi_chic, limelight_moment, halloween_punk, moving_portrait, electro_border, retro_siren, cipher_imprint, lukewarm_flash, slow_shutter, indigo_gloom, light_veil, desert_sunflare, quarter_chaos, flame_frame, dream_sunbeam, basic_flash, spectrum_scan, mind_split, sinister_spread, aura_border, sudden_negative, inflammable, stage_left_swing, spotlight_swing, soft_ray, rotating_beams, star_signal, flare_pulse, divine_glow, neon_escape, split_flash, strange_disaster, unsteady_pulse, horror_flashback, chalky_sketch, psyche_echo, soft_beam, flicker_blur, spark_2, golden_glare, gasoline_blaze, ominous_intro, blur_zoom, split_cell, halo_2, reel_burn_3, jitter_flash, negative_flash. Discovery endpoints: GET /ui/public/library/transitions and GET /ui/public/library/effects.

Request Format

Top-level request fields:

Movie Object

{
  "env": "prod",
  "sync": true,
  "movie": {
    "format": {
      "width": 1080,
      "height": 1920,
      "fps": 30,
      "background_color": "#000000"
    },
    "scenes": [],
    "overlays": [],
    "audio": [],
    "effects": [],
    "captions": {
      "style": "bold_center",
      "cues": []
    }
  }
}

Library Overview

Default assets are ready out of the box. Use them directly in editor or via API payloads.

Scenes

Scenes build the base timeline. Each scene can define transition and motion keyframes.

Transitions Catalog

Transition object fields:

Active transition types: mix, black_fade, flash, white_strobe, strobe, tremble_shrink, left, left_simple, right, right_simple, down, down_simple, up, up_simple, glitch, snap_back, blur, spin_clockwise, spin_counter_clockwise, superimpose, wipe_left, wipe_right, wipe_up, wipe_down, split_horizontal, split_vertical, slight_jitter, ghost_glow, shake_flash, dynamic_smear, burned_portal, vibrate_amped, quick_dazzle, dazzle_blur, clap_pull, matte_snapshots, snap_away, heatwave_flash, sphere_album, bw_ghost, snapshot_glam, blurry_shock, silky_switch, blur_focus, space_beam, dust_flurry, twist_flash, wavy_surf, snow_cleared, negative_dissolve, red_laser_scan, dof_twirl, seesaw_blur, retro_neon_light, velocity_stretch, 3d_scroll_down, star_screen, cube_folds, contrast_overlay, morning_glare, pull_down, flash_blast, fire_burst, magnetic_slowdown, flashing_down, horizontal_stretch, flashy_spin, stack_rotate, bounce_exchange, paper_skip, blueprint_sketch, cut_flash, shake_snap, phone_camera, shuriken_switch, red_blue_flash, shake_pass, beehive_morph, cyber_flare, dollar_sign, dof_wiggle, elastic_rush, tv_curly_lines, cyborg_blue, punch_zoom, camera_right, green_pulse, blurry_tremble, brushes_in_the_wind, overlap_swipe, night_warp, read_on_phone, ripped_collage, rapid_blinking, cubic_dance, split_off_cube, scene_flash, warp_twist, rainbow_scatter, neon_burn, cross_expand, 3_split_slide, anticlockwise_drag, gum_stretch, pull_snap, dream_light_tilt, block_slides, bw_smear, layer_rotation, shredded_pan, glass_cutting, virtual_notebook, switch_flick, washer_disco, laser_rain, radiant_wipe, lens_up, 3d_card_2, vertical_cutout_1, pull_blur, bubbly_wash, sticky_note, monster_jaws, candy_switch, rotate_fault, window_swap, neon_scuffing, star_slice, film_flipping, particle_blur, semi_reset, halved_scroll, preview_window, nesting_box, ghost_impact, light_graffiti_i, lens_down, zeroing_in, speedy_slots, 3d_rotation, white_strokes, film_negatives, 360_dark, bubble_poof, squishy_cube, slow_down_twirl, zoom_out_carousel, 3d_glass, corner_burn, dotted_bling, tablet_flip, deck_spotlight, pull_reveal, scene_flash_2, layered_glass, flashing_veil, window_swipe, slanted_cutout, film_stains, slight_rotation, winter_star, bizarre_rubik, stretch_morph, flying_card, dealing_cards, hypno_shock, wave_bling, 3_way_split, corner_up, sns_turn, negative_unveil, slide_down, expansion_transition, center_clasp, instant_polaroid, tile_view_swipe, mosaic_slide, pop_up_note, sand_sculpting, fly_away, rubik_dance, detachment, pop_switch, horizontal_cutout, mood_board, shrinking_circle, cut_out_flip, clipping_spiral, snapshot_jumps, train_wipe, omni_expand, box_shut, quartered_lens, vertical_cutout_2, rotation_transition, turning_blocks, lines_morph, hole_spots, multi_tier_feed, negative_fracture, 3_flap_turn, multi_line_slide, light_graffiti, twist_glow, 9_block_swing, sliced_ripple, intrusive_slide, pink_envelope.

Effects Catalog

Effects run on timeline intervals and are configured in effects[].settings.

For opacity-mode effects (film_grain, chalky_doodle, crowded_interview, old_error_message, film_intro, border_scrawl), use settings.opacity_pct instead of settings.strength.

Active effect types: white_flash, shutter_flash, shutter_flash_brightness, black_flash, negative, fade_in, fade_out, film_grain, blur, vignette, vignette_flash, blur_on, blur_off, chalky_doodle, diamond_blur_on, crowded_interview, zoom_in, zoom_out, zoom_in_out, jitter, zoom_top, shake, zoom_bottom, flash_jitter, glitch, zoom_left, colors_on, zoom_right, colors_off, club_mood, club_mood_2, rotate_snap, circle_flash, rotate_circle_flash, move_left, swing, move_right, shaky_highlight, zigzag_view, move_up, move_down, panel_flash, panel_flash_2, frantic_shots, frantic_shots_top, overlay_b_w_vhs, insistent_blur, overlay_bouncing_snow, overlay_buffer_overload, rotate_window, off_color_rotation, overlay_burn_scribble, low_quality, overlay_butterfly_color, overlay_canvas_doodle, popular_post, overlay_chalk_graffiti, tv_on, glowing_drift, overlay_chaos_gallery, old_error_message, overlay_chrome_glitch, laser_showcase, overlay_cold_lab, overlay_crashing_neon, warm_flash, exposure_glow, overlay_crime_of_passion, film_intro, overlay_cross_stitch_dye, overlay_cyberpunk_glitch, pink_alert, laser_fragments, overlay_digital_cam, negative_frequency, overlay_doomsday_glitch, insta_reel, overlay_dramatic_news, overlay_electric_graffiti, sun_flashes, border_scrawl, overlay_falling_petals_2, overlay_fauly_signal, whizz_slide, overlay_film_passion, scorched_hole, overlay_firescape, red_wrapper, glitter_burst_love, overlay_flowers_for_you_2, clover_rotation, overlay_flying_pellets, overlay_fortune_temple, soul_returning, leak_2, overlay_fragmented_glitch, overlay_freezing_winter, vertical_open, intense_flashback, overlay_frosted_player, clone_stretch, overlay_gauzy_illusion, hand_heart, overlay_gift_unwrapping, anime_speed, overlay_gitter_burst_love, heart_reaction, overlay_glitchy_cyberspace, monochrome_clarity, overlay_glitchy_news, garden_frame, overlay_grainy_effect, overlay_grainy_vignette, smooth_popup, overlay_graphic_error, vignette_scanlines, overlay_hardbeat_poof, room_3d, confetti_butterflies, overlay_icebreaking_song, bw_reel_jam, overlay_inflammable, bling_focus, overlay_insta_famous, overlay_katana_slash, reality_breakdown, overlay_kraft_borders, soap_bubble_heart, halo, overlay_led_hardbeat, intense_flickers, overlay_laser_showcase, gauzy_illusion, overlay_liking_post, overlay_magnifying_glass, tempo_zoom, overlay_map_cutout, pixel_hearts, negative_grime, overlay_math_invasion, golden_melody, overlay_matrix_glitches, overlay_molnochromatic_error, screen_damage, overlay_old_dv, tv_issue_overlay, convex_space, overlay_omnious_tv, igi_popup, overlay_open_folder, misalignment, overlay_painted_stars, color_distortion, overlay_petal_puff, hallucination, overlay_phone_clarity, jagged_zoom_out, overlay_phone_to_phone, hollow_masks, overlay_player_3, overlay_polaroid_simulation, vibrant_power, inversion_attack, overlay_pop, bio_horror, overlay_prism_motion, heart_splash, overlay_puzzle_refocus, overlay_question_marks, pastel_distortion, overlay_reel_terror, paper_merging, ice_breaker, overlay_repeated_warning, overlay_rotate_burst, tv_glitch, fast_drops, overlay_runway_blind, crumpled_noir, overlay_seamless_zoom, doodly_album, overlay_select_next, overlay_sharpened_negative, select_next, chaos_gallery, overlay_sinister_inkspread, green_double, overlay_slick_slide, multiplied, overlay_snowfall, anime_flashbang_2, overlay_stagelight_swing, overlay_stanger_storm, woodland_romance, burned_frame, overlay_starshine_city, mono_colors, overlay_stranger_disaster, overlay_tv_frequency, painting, firefly_heart, overlay_target_lens, overlay_tripple_players, upper_lens_glare, overlay_turbulence_echo, watercolor_burn, overlay_twisted_mockery, pool_surface, electronic_halo, overlay_vhs_adjustment, needle_shrink, overlay_vertical_slashes, overlay_video_cam, rusty_brown, overlay_vintage_tv_wall, spinning_blur, overlay_window_shadow, ring_panorama, rippling, chromatic_beats, laser_glitch, stock_info, simple_aberration, detective_folder, paint_carnival, image_stitching, film_burner, warp_spin, upside_down_split, bw_scribbles, somber_glitch, prism_wobble, filmscroll_jam, excited_stars, pulsing_stretch, windmill_tile, parallax_stack, wreath_meltdown, mass_drop, mirror_ripple, shabby_room, dark_plaid, luminal_passing, flip_zoom, ufo_encounter, purple_sparks, neon_motion, film_frame, slow_echo, fairy_hearts, infrared_scan, watery_noise, garland_frame, frame_fireworks, rose_rain, stretch_boxes, polar_sunbeams, pulsing_web, super_bokeh_spot, zoom_lens, diamond_zoom, mini_zoom, halo_blur, the_end, landscape_close, motion_blur, shimmer_360, low_exposure, square_blur, blurry_focus, portrait_open, hazy, to_color, blink, horizontal_close, camera_focus_2, cinema, blurred_love, dynamic_blur, colorize_bw, strong_sharpen, white_out, vertical_close, vertical_blur, four_screens, dual_screens, three_screens, nine_screens, six_screens, cross_split, mirror_flicker, segment_flash, cutout_flash, flashing_shards, speed_cut, cross_pulse, irregular_cuts, staggered_split, rectangle_cut, vertical_cut, rocky_split, five_flash_shots, slices_overheat, box_cut_flash, windmill_pulse, plank_flash, cut_n_paste, vertical_scan, four_panels, scrolling_error, dynamic_shapes, geometric_cutting, shape_cuts, flash_keys, explosion, leak_1, negative_strobe, dance_flash, technical_flash, sunset_1, feverish_imprint, flashlight_focus, dreamy_light, by_the_fireplace, fault_light, ghost_blast, sunset_4, divine_zoom, kinetic_shots, pink_blinkers, beam_shockwave, sonic_ripple, zoom_flash, spark, spotlight_sway, flickering_disco, paparazzi_chic, limelight_moment, halloween_punk, moving_portrait, electro_border, retro_siren, cipher_imprint, lukewarm_flash, slow_shutter, indigo_gloom, light_veil, desert_sunflare, quarter_chaos, flame_frame, dream_sunbeam, basic_flash, spectrum_scan, mind_split, sinister_spread, aura_border, sudden_negative, inflammable, stage_left_swing, spotlight_swing, soft_ray, rotating_beams, star_signal, flare_pulse, divine_glow, neon_escape, split_flash, strange_disaster, unsteady_pulse, horror_flashback, chalky_sketch, psyche_echo, soft_beam, flicker_blur, spark_2, golden_glare, gasoline_blaze, ominous_intro, blur_zoom, split_cell, halo_2, reel_burn_3, jitter_flash, negative_flash.

Overlays and Text

Overlays are rendered above scenes and effects, so they are ideal for final titles, logos, and text callouts.

Text Style Properties

Audio (Music and Sounds)

Audio items can be narration, music beds, or short sound effects. Mix with volume_db, fades, trimming, and ducking.

{
  "src": "https://store.jsonclip.com/jsonclip/libraries/audio/pixabay/action/song.mp3",
  "role": "music",
  "variable_name": "music_main",
  "from_ms": 0,
  "in_ms": 1200,
  "to_ms": 15000,
  "volume_db": -3,
  "fade_in_ms": 250,
  "fade_out_ms": 1200,
  "duck_under_voice": false
}

Captions (Presets + Files)

Captions support inline cue arrays and external subtitle files. Inline cues take priority when both are present.

Transform Keyframes

Transforms can be attached to scenes and overlays for pan/zoom/rotation choreography.

Discovery Endpoints (For Agents)

To stay current with default library metadata, query these endpoints before generating JSON:

curl -H "X-API-Key: YOUR_API_KEY" https://api.jsonclip.com/ui/library/audios
curl -H "X-API-Key: YOUR_API_KEY" https://api.jsonclip.com/ui/library/transitions
curl -H "X-API-Key: YOUR_API_KEY" https://api.jsonclip.com/ui/library/effects
curl -H "X-API-Key: YOUR_API_KEY" https://api.jsonclip.com/ui/effects-tags
curl -H "X-API-Key: YOUR_API_KEY" https://api.jsonclip.com/ui/transitions-tags

Effects and transitions endpoints return names, types, defaults, and preview assets. Audio endpoint returns both music and sounds items with genre/category metadata.

Examples

Copy and adapt these full payloads.

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "image",
      "src": "https://cdn.example.com/assets/cover.jpg",
      "duration_ms": 5000
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/intro.mp4",
      "duration_ms": 4200,
      "transition_out": {
        "type": "mix",
        "duration_ms": 500
      }
    },
    {
      "type": "image",
      "src": "https://cdn.example.com/assets/product.jpg",
      "duration_ms": 3600,
      "transition_out": {
        "type": "white_strobe",
        "duration_ms": 300
      }
    },
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/outro.mp4",
      "duration_ms": 3200
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "image",
      "src": "https://cdn.example.com/assets/city.jpg",
      "duration_ms": 6000,
      "transform": [
        {
          "at_ms": 0,
          "x_px": 540,
          "y_px": 960,
          "scale": 1,
          "rotate_deg": 0,
          "opacity_pct": 100
        },
        {
          "at_ms": 3000,
          "x_px": 620,
          "y_px": 900,
          "scale": 1.15,
          "rotate_deg": 0,
          "opacity_pct": 100
        },
        {
          "at_ms": 6000,
          "x_px": 720,
          "y_px": 860,
          "scale": 1.3,
          "rotate_deg": 0,
          "opacity_pct": 100
        }
      ]
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/background.mp4",
      "duration_ms": 7000
    }
  ],
  "overlays": [
    {
      "type": "text",
      "text": "Launch Day",
      "from_ms": 500,
      "to_ms": 6200,
      "position_px": {
        "x": 540,
        "y": 1420
      },
      "width_px": 860,
      "opacity_pct": 100,
      "fade_in_ms": 220,
      "fade_out_ms": 260,
      "style": {
        "font": "Avenir Next",
        "size_px": 94,
        "bold": true,
        "italic": false,
        "underline": false,
        "case": "upper",
        "align": "center",
        "color": "#FFFFFF",
        "character_spacing_px": 1.2,
        "line_spacing_px": 4
      },
      "stroke": {
        "color": "#111111",
        "width_px": 7
      },
      "shadow": {
        "color": "#000000",
        "opacity_pct": 58,
        "blur_pct": 45,
        "distance_px": 8,
        "angle_deg": 95
      },
      "glow": {
        "color": "#4BC6FF",
        "intensity_pct": 34,
        "range_pct": 55,
        "offset_x_px": 0,
        "offset_y_px": 0
      },
      "background": {
        "enabled": true,
        "color": "#0B0B0B",
        "opacity_pct": 48,
        "corner_radius_pct": 24,
        "height_pct": 130,
        "width_pct": 116,
        "x_offset_pct": 0,
        "y_offset_pct": 0
      },
      "transform": [
        {
          "at_ms": 500,
          "x_px": 540,
          "y_px": 1460,
          "scale": 0.9,
          "rotate_deg": 0,
          "opacity_pct": 0
        },
        {
          "at_ms": 1200,
          "x_px": 540,
          "y_px": 1420,
          "scale": 1,
          "rotate_deg": 0,
          "opacity_pct": 100
        },
        {
          "at_ms": 6200,
          "x_px": 540,
          "y_px": 1420,
          "scale": 1,
          "rotate_deg": 0,
          "opacity_pct": 0
        }
      ]
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/base.mp4",
      "duration_ms": 9000
    }
  ],
  "overlays": [
    {
      "type": "image",
      "src": "https://cdn.example.com/assets/logo.png",
      "from_ms": 0,
      "to_ms": 9000,
      "position_px": {
        "x": 920,
        "y": 140
      },
      "width_px": 220,
      "opacity_pct": 95
    },
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/b-roll.mp4",
      "from_ms": 1800,
      "duration_ms": 4000,
      "position_px": {
        "x": 540,
        "y": 1140
      },
      "width_px": 720,
      "opacity_pct": 100,
      "fade_in_ms": 200,
      "fade_out_ms": 200
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/story.mp4",
      "duration_ms": 12000
    }
  ],
  "audio": [
    {
      "src": "https://cdn.example.com/audio/voiceover.mp3",
      "role": "voice",
      "from_ms": 0,
      "to_ms": 12000,
      "volume_db": 0
    },
    {
      "src": "https://cdn.example.com/audio/music-bed.mp3",
      "role": "music",
      "from_ms": 0,
      "to_ms": 12000,
      "volume_db": -14,
      "fade_in_ms": 700,
      "fade_out_ms": 900,
      "duck_under_voice": true
    },
    {
      "src": "https://cdn.example.com/audio/whoosh.mp3",
      "role": "sound",
      "from_ms": 4200,
      "duration_ms": 650,
      "volume_db": -4
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/trailer.mp4",
      "duration_ms": 9000
    }
  ],
  "effects": [
    {
      "type": "white_flash",
      "from_ms": 0,
      "duration_ms": 1400,
      "settings": {
        "speed": 1.2,
        "strength": 1.1
      }
    },
    {
      "type": "blur",
      "from_ms": 2600,
      "to_ms": 4700,
      "settings": {
        "strength": 0.55
      }
    },
    {
      "type": "film_grain",
      "from_ms": 0,
      "to_ms": 9000,
      "settings": {
        "opacity_pct": 32
      }
    },
    {
      "type": "club_mood_2",
      "from_ms": 5200,
      "duration_ms": 2100,
      "settings": {
        "speed": 230,
        "strength": 0.72
      }
    }
  ]
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/interview.mp4",
      "duration_ms": 8000
    }
  ],
  "captions": {
    "style": "boxed_black",
    "cues": [
      {
        "from_ms": 0,
        "to_ms": 2200,
        "text": "Welcome to JSONClip."
      },
      {
        "from_ms": 2400,
        "to_ms": 4700,
        "text": "This scene was rendered from pure JSON."
      },
      {
        "from_ms": 5000,
        "to_ms": 7900,
        "text": "Now add your own assets and automate the flow."
      }
    ]
  }
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30
  },
  "scenes": [
    {
      "type": "video",
      "src": "https://cdn.example.com/assets/tutorial.mp4",
      "duration_ms": 9000
    }
  ],
  "captions": {
    "style": "minimal_bottom",
    "src": "./subtitles.srt",
    "format": "srt"
  }
}

{
  "format": {
    "width": 1080,
    "height": 1920,
    "fps": 30,
    "background_color": "#000000"
  },
  "scenes": [
    {
      "type": "image",
      "src": "./cover.jpg",
      "duration_ms": 3200,
      "transition_out": {
        "type": "mix",
        "duration_ms": 500
      }
    },
    {
      "type": "video",
      "src": "./demo.mp4",
      "duration_ms": 5200,
      "transition_out": {
        "type": "glitch",
        "duration_ms": 260
      }
    },
    {
      "type": "image",
      "src": "./cta.jpg",
      "duration_ms": 2800
    }
  ],
  "overlays": [
    {
      "type": "text",
      "text": "Automate Your Video Pipeline",
      "from_ms": 450,
      "to_ms": 10300,
      "position_px": {
        "x": 540,
        "y": 150
      },
      "width_px": 960,
      "opacity_pct": 100,
      "style": {
        "font": "Helvetica Neue",
        "size_px": 56,
        "bold": true,
        "align": "center",
        "color": "#FFFFFF"
      },
      "shadow": {
        "color": "#000000",
        "opacity_pct": 45,
        "blur_pct": 35,
        "distance_px": 6,
        "angle_deg": 90
      }
    }
  ],
  "audio": [
    {
      "src": "./voice.mp3",
      "role": "voice",
      "from_ms": 0,
      "to_ms": 11200,
      "volume_db": 0
    },
    {
      "src": "./music.mp3",
      "role": "music",
      "from_ms": 0,
      "to_ms": 11200,
      "volume_db": -13,
      "duck_under_voice": true
    },
    {
      "src": "./click.wav",
      "role": "sound",
      "from_ms": 8300,
      "duration_ms": 400,
      "volume_db": -3
    }
  ],
  "effects": [
    {
      "type": "white_flash",
      "from_ms": 0,
      "duration_ms": 1400,
      "settings": {
        "speed": 1.1,
        "strength": 1.05
      }
    },
    {
      "type": "zoom_in",
      "from_ms": 3600,
      "duration_ms": 1800,
      "settings": {
        "strength": 1.4
      }
    },
    {
      "type": "film_grain",
      "from_ms": 0,
      "to_ms": 11200,
      "settings": {
        "opacity_pct": 28
      }
    }
  ],
  "captions": {
    "style": "bold_center",
    "cues": [
      {
        "from_ms": 400,
        "to_ms": 2600,
        "text": "Input data. Render video. Ship."
      },
      {
        "from_ms": 3000,
        "to_ms": 5800,
        "text": "Transitions, effects, overlays, and subtitles."
      },
      {
        "from_ms": 6200,
        "to_ms": 10400,
        "text": "JSONClip is built for automation and AI flows."
      }
    ]
  }
}