Skip to main content
POST
cURL
이 엔드포인트를 사용하면 하나의 소스 이미지와 하나의 오디오 소스를 바탕으로 말하는 아바타 클립을 만들 수 있습니다.

호출하기 전에

  • 아바타 image 하나를 공개 URL 또는 raw base64 문자열로 제공하세요
  • Kling 픽셀 요구사항을 충족하는 아바타 이미지를 사용하세요. 너무 작은 썸네일은 생성 작업에서 거부됩니다
  • audio_id 또는 sound_file 중 정확히 하나만 보내세요
  • 첫 요청은 단순하게 시작하세요: 얼굴 이미지 1장, 오디오 클립 1개, 그리고 선택 사항인 짧은 프롬프트
  • 참조된 오디오가 연결이 필요한 이전 작업에 속하는 경우 task_id를 포함하세요
  • 더 높은 품질 경로가 꼭 필요한 경우가 아니라면 mode: std로 시작하세요

오디오 소스 규칙

  • audio_id는 이미 Kling TTS 경로를 통해 음성을 생성한 경우 가장 쉬운 방법입니다
  • sound_file은 이미 자체 MP3, WAV, M4A 또는 AAC 파일이 있는 경우 사용할 수 있습니다
  • 아바타 오디오는 길이가 2초에서 60초까지로 문서화되어 있습니다

작업 흐름

1

아바타 작업 만들기

이미지와 오디오 소스 하나를 제출한 다음, 반환된 작업 id를 저장하세요.
2

작업 폴링

작업이 최종 상태에 도달할 때까지 Kling 작업 가져오기를 계속 진행하세요.
3

완료된 결과 저장

제공업체 전달 URL 이상으로 보관해야 하는 경우 최종 결과물을 자체 스토리지에 복사하세요.
전체 파라미터 참고는 공식 Kling Avatar 문서를 확인하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

헤더

Content-Type
string

Optional content type header.

본문

application/json
image
string
필수

Avatar image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected.

prompt
string
필수

Prompt describing the desired avatar performance.

audio_id
string
필수

Audio id from a prior Kling audio task.

sound_file
string

Public audio URL when you provide your own audio.

task_id
string

Optional prior task id associated with the referenced audio asset.

mode
enum<string>

Generation mode. Use std or pro; omitted requests use std.

사용 가능한 옵션:
std,
pro

응답

200 - application/json

Task accepted.

code
integer
필수
message
string
필수
data
object
필수