Kling AI Avatar Pro
接口
POST /videos/generations
完整 URL: https://modelfold.ai/v1/videos/generations
鉴权:所有请求都需要
Authorization: Bearer <API_KEY>请求头。
模型参数直接放在 JSON 请求体中,不要套 input。请求等待生成完成后返回 data[].url;支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。
生成任务的输入参数
请求参数
请求体 (application/json)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 用于生成任务的模型名称。必填字段。 - 该接口必须使用 kling/ai-avatar-pro 模型 默认值:"kling/ai-avatar-pro"。 可选值:kling/ai-avatar-pro。 示例:kling/ai-avatar-pro。 |
image_url | string | 是 | 用作数字人形象的图像 URL(需为上传后的文件 URL,而非文件内容;支持的格式:image/jpeg、image/png;最大文件大小:10.0MB) 示例:https://file.aiquickdraw.com/custom-page/akr/section-images/175792685809077e8h8k3.png。 |
audio_url | string | 是 | 音频文件的 URL(需为上传后的文件 URL,而非文件内容;支持的格式:audio/mpeg、audio/wav、audio/x-wav、audio/aac、audio/mp4、audio/ogg;音频文件的 URL(需为上传后的文件 URL,而非文件内容;支持的格式:audio/mpeg、audio/wav、audio/x-wav、audio/aac、audio/mp4、audio/ogg;音频大小限制为100M,并且时长不超过5分钟)) 示例:https://file.aiquickdraw.com/custom-page/akr/section-images/1757925802302srqfkcqh.mp3。 |
prompt | string | 是 | 本站网关要求传入 prompt,最长 2000 字。必填,不能为空。描述人物的表情、动作和镜头,说话内容来自 audio_url。最长 5000 字符。 maxLength: 2000. 示例:一位年轻女性对着播客麦克风说话,表情自然。 |
请求示例
bash
curl -X POST "https://modelfold.ai/v1/videos/generations" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling/ai-avatar-pro",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/175792685809077e8h8k3.png",
"audio_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1757925802302srqfkcqh.mp3",
"prompt": "一位年轻女性对着播客麦克风说话,表情自然"
}'json
{
"model": "kling/ai-avatar-pro",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/175792685809077e8h8k3.png",
"audio_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1757925802302srqfkcqh.mp3",
"prompt": "一位年轻女性对着播客麦克风说话,表情自然"
}响应
200 — 生成完成。usage 返回实际计费明细;结果地址仅作结构示例。
json
{
"ok": true,
"created": 1792134000,
"data": [
{
"url": "https://modelfold.ai/uploads/outputs/result.mp4"
}
],
"usage": {}
}