> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 创建 Kling 数字人视频
> 使用 CometAPI 中的 Kling Avatar API 从图像生成数字人驱动视频。使用 POST /kling/v1/videos/avatar/image2video 快速创建图生视频数字人。
使用此端点可通过一张源图像加一个音频源创建会说话的数字人短视频。
## 调用前准备
* 提供一个数字人 `image`，可使用公开 URL 或原始 base64 字符串
* 使用符合 Kling 像素要求的数字人图像；过小的缩略图会被生成任务拒绝
* 在 `audio_id` 或 `sound_file` 中二选一发送
* 首次请求请尽量保持简单：一张人脸图像、一个音频片段，以及一个可选的简短 prompt
* 当引用的音频属于必须关联的先前任务时，请包含 `task_id`
* 除非你明确需要更高质量路径，否则请先使用 `mode: std`
## 音频源规则
* 如果你已经通过 Kling TTS 路径生成了语音，`audio_id` 是最简单的方式
* 如果你已经有自己的 MP3、WAV、M4A 或 AAC 资源，`sound_file` 可直接使用
* 文档说明数字人音频时长为 2 到 60 秒
## 任务流程
提交图像和一个音频源，然后保存返回的任务 id。
继续使用 [获取 Kling 任务](./individual-queries)，直到任务进入终态。
如果你需要在提供商交付 URL 失效后继续保留结果，请将最终资源复制到你自己的存储中。
完整参数说明请参阅 [Kling Avatar 官方文档](https://kling.ai/document-api/apiReference/model/avatar)。
## OpenAPI
````yaml api/openapi/video/kling/post-avatar.openapi.json POST /kling/v1/videos/avatar/image2video
openapi: 3.1.0
info:
title: Avatar API
version: 1.0.0
description: >-
Create a Kling avatar video task from one source image plus one audio
source.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/kling/v1/videos/avatar/image2video:
post:
summary: Create a Kling avatar task
description: >-
Submit one avatar image and exactly one audio source. Poll the returned
task id through the generic Kling query route.
operationId: avatar
parameters:
- name: Content-Type
in: header
required: false
description: Optional content type header.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- image
- prompt
oneOf:
- required:
- audio_id
- required:
- sound_file
properties:
image:
type: string
description: >-
Avatar image URL or base64 image string. Use an image that
meets Kling pixel requirements; very small thumbnails are
rejected.
prompt:
type: string
description: Prompt describing the desired avatar performance.
audio_id:
type: string
description: Audio id from a prior Kling audio task.
sound_file:
type: string
description: Public audio URL when you provide your own audio.
task_id:
type: string
description: >-
Optional prior task id associated with the referenced audio
asset.
mode:
type: string
description: >-
Generation mode. Use `std` or `pro`; omitted requests use
`std`.
enum:
- std
- pro
default:
image: https://your-image-host/avatar.jpg
prompt: The speaker talks naturally to camera
sound_file: https://your-audio-host/speech.wav
mode: std
examples:
Default:
summary: Avatar image-to-video request
value:
image: https://your-image-host/avatar.jpg
prompt: The speaker talks naturally to camera
sound_file: https://your-audio-host/speech.wav
mode: std
responses:
'200':
description: Task accepted.
content:
application/json:
schema:
type: object
required:
- code
- message
- data
properties:
code:
type: integer
message:
type: string
data:
type: object
required:
- task_id
- task_status
- created_at
- updated_at
properties:
task_id:
type: string
task_status:
type: string
task_info:
type: object
additionalProperties: true
created_at:
type: integer
updated_at:
type: integer
x-codeSamples:
- lang: Shell
label: Default
source: |
curl https://api.cometapi.com/kling/v1/videos/avatar/image2video \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "https://your-image-host/avatar.jpg",
"prompt": "The speaker talks naturally to camera",
"sound_file": "https://your-audio-host/speech.wav",
"mode": "std"
}'
- lang: Python
label: Default
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/kling/v1/videos/avatar/image2video",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"image": "https://your-image-host/avatar.jpg",
"prompt": "The speaker talks naturally to camera",
"sound_file": "https://your-audio-host/speech.wav",
"mode": "std"
},
)
result = response.json()
print(result.get("code"), result.get("data", {}).get("task_id"))
- lang: JavaScript
label: Default
source: >
const response = await
fetch("https://api.cometapi.com/kling/v1/videos/avatar/image2video",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://your-image-host/avatar.jpg",
"prompt": "The speaker talks naturally to camera",
"sound_file": "https://your-audio-host/speech.wav",
"mode": "std"
}),
});
const result = await response.json();
console.log(result.code, result.data?.task_id);
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````