4Z API

digital man

Endpoint: POST https://4zapi.com/kling/v1/videos/avatar/image2video

Parameters

  • Content-Type (header, string): Request body Content-Type, usually application/json
  • Authorization (header, string): Bearer API Key

Request body (application/json)

  • audio_id (string, required): Audio ID from preview API. Only last-30-day audio lasting 2–300s. Exactly one of audio_id or sound_file
  • callback_url (string, required): Callback URL invoked on task completion
  • external_task_id (string, required): Custom external task ID for business-side correlation
  • image (string, required): Digital-human reference image. Base64 or reachable URL; .jpg/.jpeg/.png; max 10MB; min side 300px; aspect 1:2.5–2.5:1
  • mode (string, required): video generation mode
  • prompt (string, required): positive text prompt
  • sound_file (string, required): Audio file. Base64 or reachable URL; .mp3/.wav/.m4a/.aac; ≤5MB; duration 2–300s. Exactly one of audio_id or sound_file. Invalid format/size or content issues return errors

Request example

{
  "audio_id": "825455158141661278",
  "callback_url": "",
  "external_task_id": "",
  "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
  "mode": "std",
  "prompt": "",
  "sound_file": ""
}