4Z API

数字人

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

参数

  • Content-Type (header, string): 请求体 Content-Type，一般为 application/json
  • Authorization (header, string): Bearer API Key

请求体 (application/json)

  • audio_id (string, 必填): 通过试听接口生成的音频的ID仅支持使用30天内生成的、时长不短于2秒切不超过300秒的音频audio_id、sound_file参数二选一，不能同时为空，也不能同时有值
  • callback_url (string, 必填): 任务完成回调 URL
  • external_task_id (string, 必填): 自定义外部任务 ID（便于业务侧关联）
  • image (string, 必填): 数字人参考图支持传入图片Base64编码或图片URL（确保可访问）图片格式支持.jpg / .jpeg / .png图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
  • mode (string, 必填): 生成视频的模式
  • prompt (string, 必填): 正向文本提示词
  • sound_file (string, 必填): 音频文件;支持传入音频Base64编码或图音频URL（确保可访问）;音频文件支持.mp3/.wav/.m4a/.aac，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息;仅支持使用时长不短于2秒且不长于300秒的音频;audio_id、sound_file参数二选一，不能同时为空，也不能同时有;系统会校验音频内容，如有问题会返回错误码等信息

请求示例

{
  "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": ""
}