POST/kling/v1/videos/avatar/image2video

数字人

API Key application/json

Request

请求

/kling/v1/videos/avatar/image2video

Body

必填

Bodyobject

imagestring必填

数字人参考图支持传入图片Base64编码或图片URL（确保可访问）图片格式支持.jpg / .jpeg / .png图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间

audio_idstring必填

通过试听接口生成的音频的ID仅支持使用30天内生成的、时长不短于2秒切不超过300秒的音频audio_id、sound_file参数二选一，不能同时为空，也不能同时有值

sound_filestring必填

音频文件;支持传入音频Base64编码或图音频URL（确保可访问）;音频文件支持.mp3/.wav/.m4a/.aac，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息;仅支持使用时长不短于2秒且不长于300秒的音频;audio_id、sound_file参数二选一，不能同时为空，也不能同时有;系统会校验音频内容，如有问题会返回错误码等信息

promptstring必填

正向文本提示词

modestring必填

生成视频的模式

callback_urlstring必填

external_task_idstring必填

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/videos/avatar/image2video \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "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",
  "audio_id": "825455158141661278",
  "sound_file": "",
  "prompt": "",
  "mode": "std",
  "callback_url": "",
  "external_task_id": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

数字人

请求

Body

路径、查询与 Header 参数

返回响应 200

返回响应 `200`