소개
3D to Video는 대략적인 3D 애니메이션을 완성도 있는 쇼트로 만듭니다. 텍스트 기반 영상 모델이 원하는 카메라 각도를 골라 주길 기다리는 대신 3D 도구에서 움직임을 정하고 회색 영상으로 렌더링합니다. 그러면 모델이 미리 스타일을 입힌 프레임을 참고해 영상을 채웁니다. 결과는 설정한 타이밍과 구도를 유지하고 해당 프레임의 색상, 빛, 재질을 반영합니다.
핵심 기능 및 하이라이트
레이아웃으로 움직임을 제어합니다
걷는 우주비행사 장난감을 천천히 공전하는 카메라로 촬영한 3초 클레이 클립을 테스트했습니다. 결과는 24fps, 3.0초였으며 걸음마다의 동작과 카메라의 곡선 이동이 레이아웃과 일치했습니다. 출력 길이는 최대 2분까지 항상 레이아웃 길이와 같습니다.
스타일을 입힌 프레임 하나로 표현을 정합니다
레이아웃의 첫 프레임을 골든아워의 화성 평원으로 바꾸자 영상 전체에 먼지 낀 붉은 지면, 낮은 메사 지형, 따뜻한 림 라이트, 긴 그림자가 반영됐습니다. 같은 방식으로 바꾼 마지막 프레임을 last_image_url로 추가하자 4초 버전도 마지막 프레임까지 일관된 모습을 유지했습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 레이아웃 입력입니다. 3D 장면의 회색 또는 클레이 렌더를 MP4나 WebM으로 보내며 최대 120초입니다. 1자 이상 |
image_url | 예 | 스타일 입력입니다. 이미지 모델로 레이아웃의 첫 프레임에 색상, 빛, 재질, 배경을 입힌 이미지입니다. 1자 이상 |
last_image_url | 아니요 | 선택 항목입니다. 약 3초보다 긴 쇼트에서 스타일을 안정적으로 유지하도록 레이아웃의 마지막 프레임을 같은 스타일로 바꿔 보냅니다. 1자 이상 |
prompt | 예 | 완성된 쇼트를 스타일 이미지와 일치하도록 한두 문장으로 설명합니다. 클레이, 3D, 레이아웃은 언급하지 않습니다. 1자 이상 · 2000자 이하 |
resolution | 아니요 | 720p 또는 기본값 1080p를 선택합니다. 레이아웃의 화면 비율은 보존하며 해상도에 따라 초당 요금을 결정합니다. |
seed | 아니요 | 결과 재현을 위해 선택적으로 지정하는 정수입니다. 시드 설정에 따른 요금 차이는 없습니다. |
요금
레이아웃 영상의 길이를 초 단위로 올림해 최소 3초, 최대 120초분을 과금합니다. 초당 요금은 resolution에 따라 달라지며 1080p가 720p보다 높습니다. 마지막 프레임의 스타일 이미지, prompt, seed는 요금에 영향을 주지 않습니다. 실패한 작업은 과금하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.048 / 초 |
| $0.12 / 초 |
활용 사례
프리비즈를 제안용 영상으로 바꿉니다
임시 모델과 실제 카메라 움직임으로 장면을 구성한 뒤 스타일을 적용한 클립으로 만듭니다. 제안서, 스토리보드 검토, 소셜 티저에 활용합니다. 아이디어가 승인되기 전에 재질, 조명 리그, 전체 환경을 모두 만들 필요가 없습니다.
하나의 애니메이션에 여러 배경을 입힙니다
레이아웃 하나를 유지한 채 스타일 이미지와 설명 문장만 바꿉니다. 같은 걷는 캐릭터나 회전하는 제품을 숲, 네온이 빛나는 밤의 도시, 손으로 그린 만화 세계에 배치할 수 있습니다. 모든 버전의 타이밍이 같으므로 클립을 이어 편집하기도 수월합니다.
프롬프트 가이드 및 실전 팁
스타일 이미지를 세심하게 준비합니다
실제로 전송할 레이아웃에서 정확히 첫 번째 프레임을 내보내 이미지 모델로 스타일을 바꿉니다. 포즈, 프레이밍, 수평선은 원래 위치를 유지합니다. 스타일 이미지가 레이아웃과 잘 맞을수록 경계가 깔끔해지고 결과도 안정적입니다. 수정하지 않은 회색 프레임을 업로드하면 결과 역시 회색으로 남습니다.
prompt는 짧고 시각적으로 씁니다
완성 장면을 쉬운 말로 한두 문장 설명합니다. 예를 들어 ‘A small astronaut in a white spacesuit walks across a dusty red Martian plain at golden hour while the camera slowly circles.’처럼 작성합니다. 보는 사람에게 보일 것을 묘사하며 클레이, 회색 모델, 3D, 레이아웃 자체는 언급하지 않습니다.
긴 쇼트는 나눠서 계획합니다
약 3초를 넘는다면 레이아웃의 마지막 프레임도 스타일을 바꿔 last_image_url로 전달합니다. 2분을 넘는 쇼트는 나눠야 합니다. 동일한 스타일 이미지와 seed를 사용해 각 부분을 따로 렌더링하면 장면 사이의 표현을 맞출 수 있습니다.
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/3d-to-video-v1/video-edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 레퍼런스에서 확인하세요.