소개
모션 영상을 업로드하고 참고 이미지를 최대 10장 추가하거나 캐릭터를 글로 설명하십시오. 결과 길이는 영상을 따릅니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 영상 |
| 작업 | 동작 영상 기반 캐릭터 애니메이션 |
| 필수 원본 | 동작 영상 URL, 최대 30초 클립 |
| 참조 이미지 | 선택 사항, 최대 10장, 맨 앞 이미지로 연기할 캐릭터 지정 |
| 프롬프트 | 제공 시 1~2,000자, 이미지가 없으면 필수 |
| 출력 높이 | 출력 높이: 480p / 720p (기본 설정: 720p) |
| 해상도별 요금 | 720p 요금은 480p의 두 배 |
| 오디오 제어 | 기본으로 새 소리 생성, 끄면 원본 소리 유지 |
| 영상 가이드 | 원본 길이, 카메라, 배경을 따르는 결과 |
| 청구 기준 | 동작 영상의 초 단위 올림, 최소 4초분 |
| 실패한 실행 | 요금 없음 |
| 기록된 출력 | 480 x 854 MP4, 5초 클립에서 4.71초 반환 |
핵심 기능 및 하이라이트
참조 캐릭터가 수행하는 루틴
캐릭터 이미지 1장과 5초 구동 클립으로 회색 스튜디오의 480p 연기 영상을 얻었습니다. MP4는 480 x 854픽셀로 측정했으며 길이는 4.71초로 확인했습니다. 시간이 정해진 편집을 계획할 때는 입력 길이와 함께 검토해야 합니다. 기록된 결과는 원본보다 짧았음을 확인했습니다.
누가 움직일지 정하고 움직임을 보여 줍니다
동작 클립에서 동작, 카메라, 배경을 가져옵니다. 최대 10장인 이미지 목록의 맨 앞에 연기할 캐릭터 이미지를 배치하거나, 이미지가 없으면 글로 캐릭터를 정의합니다. 이미지를 사용하는 요청에도 프롬프트로 지시를 추가할 수 있음을 안내합니다.
해상도와 오디오를 의도에 맞게 설정합니다
출력 높이는 480p 또는 720p이며, 기본 선택인 720p에는 480p의 두 배 요금을 적용합니다. 소리 생성도 기본으로 활성화합니다. 구동 클립의 소리를 연기에 유지하려면 비활성화해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 30초 이내의 모션 영상입니다. 4초 미만은 4초로 과금됩니다. 1자 이상 |
reference_image_urls | 아니요 | 이미지는 최대 10장이며 첫 번째 이미지가 동작을 연기할 캐릭터입니다. 10개 이하 |
prompt | 아니요 | 추가 지시입니다. 이미지를 넣지 않으면 필수입니다. 1자 이상 · 2000자 이하 |
resolution | 아니요 | 480p 또는 720p(기본)입니다. 720p는 요금이 2배입니다. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. 끄면 모션 영상의 소리를 유지합니다. 기본값: |
요금
Motion Control Flash는 모션 영상의 시작된 초마다 과금되며 최소 4초가 적용됩니다. 완료되지 않은 실행은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.162 / 초 |
| $0.324 / 초 |
활용 사례
스튜디오 안무 연구
루틴 클립과 캐릭터 이미지를 조합해 해당 캐릭터가 동작을 수행하는 모습을 검토합니다. 이번 회색 스튜디오 예시에서는 5초 원본으로 480p, 480 x 854 MP4를 얻었으며 길이는 4.71초로 확인했습니다.
발표자 제스처 리허설
녹화한 발표자 제스처를 동작 레퍼런스로 사용하고 캐릭터 이미지를 추가합니다. 발표에 사용할 카메라와 배경을 갖춘 영상을 선택한 뒤 편집 전에 반환된 제스처를 검토해야 합니다.
설명으로 만드는 캐릭터 구상
일반적인 작업복을 입은 워크숍 강사, 갤러리 안내원 또는 다른 직업인을 설명한 뒤 연기 클립을 제공합니다. 업로드할 이미지가 없으면 프롬프트로 캐릭터를 정의합니다.
기존 소리를 활용한 연기
소리 생성을 꺼서 루틴과 기존 소리가 함께 유지되도록 합니다. 더 긴 시퀀스에 연기를 넣기 전에 반환된 오디오와 영상을 함께 검토해야 합니다.
프롬프트 가이드 및 실전 팁
연기 클립을 선택합니다
최대 30초인 동작 영상의 URL을 제공합니다. 동작, 카메라, 배경이 의도한 결과에 맞는 영상을 선택해야 합니다.
연기할 캐릭터를 지정합니다
캐릭터 이미지를 맨 앞에 두고 최대 10장을 추가합니다. 이미지를 사용하지 않으면 필수 프롬프트에 캐릭터를 설명해야 합니다.
화면 크기와 소리를 설정합니다
동작을 적용한 영상은 480p 또는 720p 해상도로 요청합니다. 기본값인 720p는 480p의 두 배 요금을 적용합니다. 새 오디오를 만들려면 소리 생성을 켜고, 동작 클립의 소리를 유지하려면 꺼야 합니다.
반환된 연기를 검토합니다
동작, 캐릭터 외형, 반환된 길이를 원본과 비교합니다. 이번 스튜디오 예시는 5초 구동 클립에서 4.71초를 반환했으므로 편집 타임라인에 배치하기 전에 결과를 확인해야 합니다.
녹화한 연기로 캐릭터를 움직입니다
Motion Control Flash 캐릭터 애니메이션은 동작 영상을 입력받아 이미지나 설명으로 지정한 캐릭터의 연기를 렌더링합니다. 구동 클립에서 동작, 카메라, 배경을 정합니다. 재사용하려는 동작의 녹화본이 이미 있을 때 이 작업 흐름을 선택합니다.
캐릭터를 글로 설명하더라도 동작 영상은 필수입니다. 프롬프트는 지시를 추가하며 녹화된 연기를 대신하지 않습니다.
요청 매개변수
요청을 준비할 때 연기의 원본과 캐릭터 참조 자료를 구분합니다. 다음 설정으로 입력, 출력 높이, 소리 처리 방식을 정합니다.
| 매개변수 | 요구 사항과 선택지 | 요청에서의 역할 |
|---|---|---|
video_url | 비어 있지 않은 문자열 필수, 최대 30초 동작 클립 | 연기, 카메라, 배경, 기준 길이를 제공합니다 |
reference_image_urls | 선택적 배열, 최대 10장 | 목록 맨 앞 이미지로 동작을 수행할 캐릭터를 지정합니다 |
prompt | 이미지가 있으면 선택 사항, 없으면 필수, 제공 시 1~2,000자 | 캐릭터를 설명하거나 지시를 추가합니다 |
resolution | 480p 또는 720p, 기본값 720p | 출력 높이를 선택하며 720p에는 480p의 두 배 요금을 적용합니다 |
generate_audio | 불리언, 기본값 true | 켜면 새 소리를 생성하고 끄면 동작 클립의 소리를 유지합니다 |
이미지나 글로 캐릭터를 정의합니다
원하는 연기자의 이미지를 참조 목록 맨 앞에 배치합니다. 이미지는 최대 10장까지 포함합니다. 제출 전에 순서를 확인하여 의도한 연기자가 목록 맨 앞에 있도록 해야 합니다.
이미지가 없으면 프롬프트에 캐릭터 설명을 작성합니다. 직업, 일반적인 의상, 장면에서의 역할을 명시하면 구체적인 초안을 작성할 수 있습니다. 이미지 기반 요청에서는 관련 없는 연기를 묘사하는 대신 이미지 속 캐릭터를 지정하고 필요한 지시를 추가해야 합니다.
프롬프트 작성 전에 클립을 선택합니다
결과가 원본 카메라와 배경을 따르므로 의도한 영상에 맞는 구도와 환경의 녹화본으로 시작합니다. 입력 제한인 30초 이내에서 필요한 동작에 맞춰 원본을 다듬어야 합니다. 제출 전에 원본 전체를 보고 반환된 연기에서 어떤 움직임을 확인할지 결정합니다.
프롬프트에 명확한 역할을 부여합니다
기록된 요청에서는 "The character from image 1 performs the routine in a warm grey photo studio."를 사용했습니다. 이미지 속 캐릭터와 루틴을 연결하고 새 동작 순서를 나열하지 않으면서 환경을 명시합니다. 자신의 지시를 작성할 때도 이 역할 구분을 활용합니다. 클립은 연기를 보여 주고 글은 대상을 지정하거나 명확하게 합니다.
글로 작성한 환경과 일치하는 원본을 선택해야 합니다. 구동 클립에서 배경을 가져오므로 장면 설명을 원본과 일관되게 유지합니다. 프롬프트는 2,000자 이내로 작성하고 나중에 검토할 수 있도록 선택한 입력과 함께 저장해야 합니다.
해상도, 소리, 요금
동작 기반 캐릭터 영상에는 선택한 해상도에 맞춰 여기 표시된 요금을 적용합니다. 동작 영상의 초 단위 길이를 올림하여 청구하며 최소 4초분을 적용합니다. 실패한 실행에는 요금을 청구하지 않습니다. 청구 기준은 입력 동작 영상이므로 반환된 파일의 길이로 추정하지 않아야 합니다.
기본 출력 높이는 720p입니다. 초안에 해당 높이가 적합하면 480p를 명시적으로 선택합니다. 720p에는 두 배 요금을 적용합니다. 이번 스튜디오 예시에서는 480p에서 480 x 854픽셀의 세로 MP4를 얻었습니다.
원본 소리를 유지할지 결정합니다
소리 생성은 처음에 활성화합니다. 새 소리가 필요하면 켜 두고 동작 클립의 소리를 원하면 generate_audio를 false로 설정합니다. 편집에 사용하기 전에 반환된 파일의 소리를 확인해야 합니다.
회색 스튜디오의 루틴
2026년 11월 18일, 5초 구동 클립에 참조 이미지 1장과 위의 스튜디오 프롬프트를 추가하고 480p를 선택해 제출했습니다. 반환된 MP4에서는 참조 캐릭터가 회색 스튜디오에서 루틴을 수행했습니다. 크기는 480 x 854픽셀로 측정했으며 길이는 4.71초로 확인했습니다.
반환된 길이는 원본보다 짧았음을 확인했습니다. 다른 트랙에 맞추거나 시간이 정해진 시퀀스에 배치하기 전에 미디어 길이를 확인해야 합니다. 동작의 시작과 끝을 원본과 함께 검토하고 편집을 구성할 때는 반환된 파일의 실제 길이를 사용합니다.
제한과 관련 선택지
최대 30초 동작 클립, 10장 이하의 참조 이미지, 명시된 글자 수 제한 내의 프롬프트를 준비합니다. 반환된 파일에서 동작, 외형, 구도, 소리를 검토해야 합니다. 다음 버전에서 조정할 부분을 파악하도록 입력 클립, 캐릭터 참조 자료, 프롬프트를 함께 보관합니다.
입력이 다르면 다른 제품군과 비교합니다
적절한 동작 클립이 없으면 엔드포인트를 선택하기 전에 Kling 3.0의 작업 흐름을 확인합니다. 다른 캐릭터 애니메이션 제품군과 비교할 때는 Wan 2.2 Animate의 필수 입력과 출력 설정을 확인해야 합니다. 보유한 원본 소재와 장면에 필요한 제어 항목을 기준으로 선택합니다.
연기, 카메라, 배경이 의도한 장면에 맞는 동작 클립을 선택해야 합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/motion-control-flash/character-animation",
"input": {
"resolution": "720p",
"video_url": "https://example.com/reference.mp4",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.


