고품질 비디오 애니메이션을 생성하여 이미지를 생생하게 만드세요.

이미지를 비디오로

이미지를 비디오로 엔드포인트는 텍스트 프롬프트를 기반으로 고품질 비디오 애니메이션을 생성하여 정적 이미지를 생생하게 만듭니다.

모델 이름: image-to-video

수명 주기: experimental

처리 시간: ~60초–180초

출력 형식: MP4

전달 방식: URL (상태 폴링을 통해)

크레딧: 비디오당 6~12개 (길이에 따라 다름)

요청

범용 /v1/run 엔드포인트에 이미지와 프롬프트를 제출하여 비디오를 생성하세요:

POSThttps://fititon.app/api/v1/run

요청 예시

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

응답

비디오 생성에는 몇 분이 소요되므로, /v1/run 엔드포인트는 비동기 작업 id와 함께 즉시 200 OK 상태를 반환합니다. 최종 MP4 URL을 검색하려면 GET /v1/status/{id}를 사용하여 상태 API를 폴링해야 합니다. 또는 웹훅을 구성하여 알림을 자동으로 받을 수 있습니다. 당사의 웹훅 디스패처는 엄격한 15초 타임아웃을 적용합니다. 서버는 15초 이내에 2xx 상태 코드로 웹훅을 승인해야 하며, 그렇지 않으면 실패로 간주되어 나중에 다시 시도됩니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

요청 매개변수

필수 매개변수

imageUrlRequiredstring

애니메이션을 적용할 입력 이미지. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 이미지 문자열일 수 있습니다.

전문가 팁: 머리카락, 직물 또는 나뭇잎이 보이는 이미지는 가장 자연스러운 움직임을 생성합니다. 정적인 플랫 레이 또는 제품 전용 사진은 애니메이션이 잘 되지 않습니다. 사람이나 장면이 있는 이미지를 사용하세요. AI가 움직일 공간을 확보할 수 있도록 과도하게 잘린 이미지는 피하세요.

형식 요구 사항 Base64 문자열을 제출할 때, 표준 데이터 URI 접두사(예: data:image/jpeg;base64,...)를 포함해야 합니다.

선택적 매개변수

promptstring

애니메이션을 안내하는 텍스트 설명. 생략하면 AI가 이미지 컨텍스트에서 자연스러운 움직임을 추론합니다.

durationinteger

생성된 비디오의 길이(초). 지원되는 값: 4, 6, 8. 기본값: 6

aspectRatio'16:9' | '9:16'

출력 비디오의 종횡비. 기본값: 9:16

generateAudioboolean

비디오에 맞춰 상황에 맞는 AI 오디오를 생성할지 여부. 기본값: true

런타임 오류

이 기능의 런타임 오류는 오류 처리에 문서화된 공유 세트를 사용합니다. 처리 중에 오류가 발생하면 status가 "error"로 업데이트되고 error 필드에 특정 실패 이유가 포함됩니다.

크레딧 비용

개발자 API 요청의 경우, 비용은 전적으로 요청된 비디오 duration에 따라 달라집니다.

공식: Cost = DurationCredits

길이	비디오당 크레딧
4초	6
6초 (기본값)	9
8초	12