메인 콘텐츠로 건너뛰기
POST
cURL
POST /motion-control/{model}을 사용하여 참조 비디오의 움직임으로 캐릭터 이미지에 애니메이션을 적용합니다. 요청은 비동기 작업을 생성합니다.

모델 선택

캐릭터 이미지와 참조 비디오는 공개적으로 액세스할 수 있는 URL로 사용하세요. 참조 비디오의 오디오를 유지하려면 settings.audio을 original로 설정하고, 무음 출력을 생성하려면 off로 설정하세요. 이미지는 JPG 또는 PNG 형식이어야 하며, 최대 50MB이고 각 변의 길이가 최소 300픽셀이어야 합니다. 참조 비디오는 길이 3초 이상, 크기 100MB 이하의 MP4 또는 MOV를 사용하세요. character_orientation: image에서는 비디오 길이가 최대 10초이고, video에서는 최대 30초입니다.

요청 파라미터

캐릭터 이미지에 애니메이션을 적용하려면 이 요청 본문을 POST /motion-control/kling-2.6에 전송하세요. 자체 캐릭터와 모션을 사용할 때는 미디어 URL을 액세스 가능한 자체 파일로 바꾸세요:
응답은 비동기 작업의 id을 반환합니다:
data.id 값을 다음과 함께 사용하세요 Kling 작업 가져오기 작업이 완료될 때까지 사용하세요. 완료된 비디오 URL은 작업의 outputs 배열에서 읽으세요. 지속적인 액세스가 필요하면 비디오를 자체 스토리지에 저장하세요. OpenAPI 패널에는 이에 대응하는 Shell, Python, JavaScript 요청이 포함되어 있습니다. 추가 입력 세부 정보는 다음을 참조하세요. Kling 모션 제어 API 참조.

인증

Authorization
string
header
필수

Authenticate with your CometAPI API key.

경로 매개변수

model
enum<string>
필수

Kling motion-control model ID.

사용 가능한 옵션:
kling-3.0,
kling-2.6

본문

application/json

Motion-control request fields exposed by the CometAPI route. The model ID is a path parameter, not a body field.

contents
object[]
필수

Send a character image and motion reference video. Add a prompt item for scene guidance.

Minimum array length: 2
settings
object
필수

Output resolution, reference orientation, and explicitly selected audio behavior.

options
object

Optional task fields exposed by the CometAPI route.

응답

200 - application/json

Task created. Store data.id for a GET /tasks query.

code
필수

Result code. 0 indicates task creation.

message
string
필수

Result message.

data
object
필수

Task identification and submission status.

msg
string

Additional result message, when included.

마지막 수정일 2026년 9월 25일