API reference · KwaiVGI

Kling 1.6

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

VIDEOAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDkwaivgi/kling-video/1.6/pro/effects

Input Schema

3 parameters · 0 required · 3 optional

Parameter	Type	Required	Description
`duration`	integer	Optional	The duration of the generated video in seconds · Options: 5, 10 · Default: 5 510
`effect_scene`	string	Optional	The effect scene to use for the video generation · Options: hug, kiss, heart_gesture, squish, expansion, fuzzyfuzzy, bloombloom, dizzydizzy, jelly_press, jelly_slice, jelly_squish, jelly_jiggle, pixelpixel, yearbook, instant_film, anime_figure, rocketrocket, fly_fly, disappear, lightning_power, bullet_time, bullet_time_360, media_interview, day_to_night, let's_ride, jumpdrop, swish_swish, running_man, jazz_jazz, swing_swing, skateskate, building_sweater, pure_white_wings, black_wings, golden_wing, pink_pink_wings, rampage_ape, a_list_look, countdown_teleport, firework_2026, instant_christmas, birthday_star, firework, celebration, tiger_hug_pro, pet_lion_pro, guardian_spirit, squeeze_scream, inner_voice, memory_alive, guess_what, eagle_snatch, hug_from_past, instant_kid, dollar_rain, cry_cry, building_collapse, mushroom, jesus_hug, shark_alert, lie_flat, polar_bear_hug, brown_bear_hug, office_escape_plow, watermelon_bomb, boss_coming, wig_out, car_explosion, tiger_hug, siblings, construction_worker, snatched, felt_felt, plushcut, drunk_dance, drunk_dance_pet, daoma_dance, bouncy_dance, smooth_sailing_dance, new_year_greeting, lion_dance, prosperity, great_success, golden_horse_fortune, red_packet_box, lucky_horse_year, lucky_red_packet, lucky_money_come, lion_dance_pet, dumpling_making_pet, fish_making_pet, pet_red_packet, lantern_glow, expression_challenge, overdrive, heart_gesture_dance, poping, martial_arts, running, nezha, motorcycle_dance, subject_3_dance, ghost_step_dance, phantom_jewel, zoom_out, cheers_2026, kiss_pro, fight_pro, hug_pro, heart_gesture_pro, dollar_rain_pro, pet_bee_pro, santa_random_surprise, magic_match_tree, happy_birthday, thumbs_up_pro, surprise_bouquet, bouquet_drop, 3d_cartoon_1_pro, glamour_photo_shoot, box_of_joy, first_toast_of_the_year, my_santa_pic, santa_gift, steampunk_christmas, snowglobe, christmas_photo_shoot, ornament_crash, santa_express, particle_santa_surround, coronation_of_frost, spark_in_the_snow, scarlet_and_snow, cozy_toon_wrap, bullet_time_lite, magic_cloak, balloon_parade, jumping_ginger_joy, c4d_cartoon_pro, venomous_spider, throne_of_king, luminous_elf, woodland_elf, japanese_anime_1, american_comics, snowboarding, witch_transform, vampire_transform, pumpkin_head_transform, demon_transform, mummy_transform, zombie_transform, cute_pumpkin_transform, cute_ghost_transform, knock_knock_halloween, halloween_escape, baseball, korean_baseball, trampoline, trampoline_night, pucker_up, feed_mooncake, flyer, dishwasher, pet_chinese_opera, magic_fireball, gallery_ring, pet_moto_rider, muscle_pet, pet_delivery, mythic_style, steampunk, 3d_cartoon_2, pet_chef, santa_gifts, santa_hug, girlfriend, boyfriend, heart_gesture_1, pet_wizard, smoke_smoke, gun_shot, double_gun, pet_warrior, long_hair, pet_dance, wool_curly, pet_bee, marry_me, piggy_morph, ski_ski, magic_broom, splashsplash, surfsurf, fairy_wing, angel_wing, dark_wing, emoji hugkissheart_gesturesquishexpansionfuzzyfuzzybloombloomdizzydizzyjelly_pressjelly_slicejelly_squishjelly_jigglepixelpixelyearbookinstant_filmanime_figurerocketrocketfly_flydisappearlightning_powerbullet_timebullet_time_360media_interviewday_to_nightlet's_ridejumpdropswish_swishrunning_manjazz_jazzswing_swingskateskatebuilding_sweaterpure_white_wingsblack_wingsgolden_wingpink_pink_wingsrampage_apea_list_lookcountdown_teleportfirework_2026instant_christmasbirthday_starfireworkcelebrationtiger_hug_propet_lion_proguardian_spiritsqueeze_screaminner_voicememory_aliveguess_whateagle_snatchhug_from_pastinstant_kiddollar_raincry_crybuilding_collapsemushroomjesus_hugshark_alertlie_flatpolar_bear_hugbrown_bear_hugoffice_escape_plowwatermelon_bombboss_comingwig_outcar_explosiontiger_hugsiblingsconstruction_workersnatchedfelt_feltplushcutdrunk_dancedrunk_dance_petdaoma_dancebouncy_dancesmooth_sailing_dancenew_year_greetinglion_danceprosperitygreat_successgolden_horse_fortunered_packet_boxlucky_horse_yearlucky_red_packetlucky_money_comelion_dance_petdumpling_making_petfish_making_petpet_red_packetlantern_glowexpression_challengeoverdriveheart_gesture_dancepopingmartial_artsrunningnezhamotorcycle_dancesubject_3_danceghost_step_dancephantom_jewelzoom_outcheers_2026kiss_profight_prohug_proheart_gesture_prodollar_rain_propet_bee_prosanta_random_surprisemagic_match_treehappy_birthdaythumbs_up_prosurprise_bouquetbouquet_drop3d_cartoon_1_proglamour_photo_shootbox_of_joyfirst_toast_of_the_yearmy_santa_picsanta_giftsteampunk_christmassnowglobechristmas_photo_shootornament_crashsanta_expressparticle_santa_surroundcoronation_of_frostspark_in_the_snowscarlet_and_snowcozy_toon_wrapbullet_time_litemagic_cloakballoon_paradejumping_ginger_joyc4d_cartoon_provenomous_spiderthrone_of_kingluminous_elfwoodland_elfjapanese_anime_1american_comicssnowboardingwitch_transformvampire_transformpumpkin_head_transformdemon_transformmummy_transformzombie_transformcute_pumpkin_transformcute_ghost_transformknock_knock_halloweenhalloween_escapebaseballkorean_baseballtrampolinetrampoline_nightpucker_upfeed_mooncakeflyerdishwasherpet_chinese_operamagic_fireballgallery_ringpet_moto_ridermuscle_petpet_deliverymythic_stylesteampunk3d_cartoon_2pet_chefsanta_giftssanta_huggirlfriendboyfriendheart_gesture_1pet_wizardsmoke_smokegun_shotdouble_gunpet_warriorlong_hairpet_dancewool_curlypet_beemarry_mepiggy_morphski_skimagic_broomsplashsplashsurfsurffairy_wingangel_wingdark_wingemoji
`input_image_urls`	string[]	Optional	URL of images to be used for hug, kiss or heart_gesture video.

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "kwaivgi/kling-video/1.6/pro/effects",
  "duration": 5,
  "effect_scene": "hug",
  "input_image_urls": [
    "https://static.sandbase.ai/examples/kwaivgi/kling-video/1.6/pro/effects/input_input_image_urls_0.png",
    "https://static.sandbase.ai/examples/kwaivgi/kling-video/1.6/pro/effects/input_input_image_urls_1.png"
  ],
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Kling 1.6