영상이 참조를 그대로 지키나요?

첫 프레임이 결과를 고정하지만 얼마나 엄격히 지키는지는 엔드포인트마다 다릅니다. 각 모델 페이지에 그 엔드포인트의 동작과 공개된 컨트롤이 적혀 있습니다.

더 긴 영상을 만들려면?

엔드포인트가 허용하는 범위에서 duration_seconds를 올리거나, 컷별로 생성해 직접 이어 붙이세요. 길이는 엔드포인트마다 상한이 있고 초 단위로 과금됩니다.

생성이 실패하면 어떻게 되나요?

안정된 errorCode를 가진 종단 레코드가 돌아오고 보류는 전액 해제됩니다. 재시도는 원본 레코드를 건드리지 않고 같은 소재로 새 작업을 만듭니다.

연동 가이드

이미 마음에 드는 정지 컷을 움직이세요.

이미지-투-비디오는 가장 어려운 변수인 장면의 생김새를 없애고, 훨씬 좁은 질문으로 바꿉니다. 어떻게 움직일 것인가입니다. 참조 프레임이 대부분의 일을 하므로, 약한 참조는 프롬프트로 되살릴 수 없습니다.

이 작업의 모델 API 문서

해결 과제

결과의 대부분은 참조 프레임이 결정합니다

모션 엔드포인트는 첫 프레임에서 모든 것을 물려받습니다. 구도, 조명, 화면비, 잡티까지. 흐릿하거나 잘못 잘린 참조는 흐릿하고 잘못 잘린 영상이 되고, 요금은 영상 요율입니다.

비율 불일치는 조용히 비쌉니다

참조가 1:1인데 16:9 영상을 요구하면 엔드포인트는 레터박스, 크롭, 늘리기 중 하나를 합니다. 제출 전에 요청할 aspect_ratio나 resolution에 참조를 맞추세요.

마지막 프레임을 받는 엔드포인트도 있습니다

last_image_url을 선언한 곳에서는 양 끝을 주면 시작과 끝이 정해지고, 정처 없는 표류가 되지 않습니다. 선언하지 않은 곳에 보내면 400입니다.

모션 필드는 선언한 엔드포인트에만 존재합니다

movement_amplitude, camera_fixed, fps, duration_seconds는 엔드포인트마다 등장하고, 어느 것이 요율을 움직이는지는 스키마에 표시됩니다. 밑에 깔린 공통 모션 어휘 같은 것은 없습니다.

구현 방식

프레임을 먼저 고정하고, 움직임에는 한 번만 지불하세요

정지 컷 작업은 한 번 반복에 몇 센트인 이미지 엔드포인트에서 끝내고, 프레임을 고정한 다음에 모션에 지불하세요. 커밋된 spicy:// 업로드를 넘기면 재실행 사이에 참조가 바이트 단위로 같아져, 같은 픽셀에서 다시 시작합니다.

본문은 이미지 필드를 가진 생성 호출입니다. 추적하는 쪽은 다른 미디어 작업과 완전히 같습니다.

POST /api/v1/jobs/createTask

POST /api/v1/jobs/createTask
Authorization: Bearer $SPICY_API_KEY
Idempotency-Key: 7b1f0c2e-9a4d-4f31-8c67-2b5e0d9a1c44
Content-Type: application/json
{
  "model": "<publisher>/<model>/image-to-video",
  "input": {
    "prompt": "Slow push-in, fabric moving in a light breeze",
    "image_url": "https://example.com/reference.png",
    "duration_seconds": 5,
    "resolution": "720p"
  },
  "callBackUrl": "https://example.com/hooks/spicyapi"
}

202 Accepted

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

계약

먼저 못 박아 둘 항목

이미지-투-비디오 API: 정지 컷을 움직이게 — 먼저 못 박아 둘 항목
필드 또는 헤더	값 또는 상한
image_url · last_image_url	declared per endpoint
POST /api/v1/jobs/retry	new task · source record untouched
state	queued · running · succeeded · failed · expired
audio / video upload	≤ 100 MiB · ≤ 600 s

좌우로 밀어 모든 항목을 확인하세요.

연동

첫 호출에서 운영까지

01출력할 화면비 그대로 참조 프레임을 만들거나 올립니다.
02엔드포인트 스키마에서 image_url·duration_seconds·resolution과 선언된 모션 필드를 확인합니다.
03견적 후 Idempotency-Key와 콜백 URL을 붙여 보내고, taskId를 참조와 함께 저장합니다.
04종단 콜백에서 output.assets를 내려받고, 다시 돌릴 수 있도록 참조를 영상 옆에 남깁니다.

적합성

이 경로가 맞는 경우

이럴 때 고르세요

아트 디렉션이 정지 컷에서 이미 확정되었고, 장면을 다시 뽑지 않고 움직임만 더하고 싶다.
같은 캐릭터나 같은 제품이 모든 영상에서 똑같이 보여야 한다.

이럴 때는 다른 길로

장면이 아직 없는 경우. 정지 컷에서 반복하는 편이 영상에서 반복하는 것보다 한 자릿수 저렴합니다.
여러 컷에 걸친 장편 연속성이 필요한 경우. 이 엔드포인트들은 한 컷씩 짧은 영상을 돌려줍니다.

근거

직접 확인할 수 있는 것

참조 처리 방식은 어디서나 같습니다

HTTPS URL, 커밋된 spicy:// 업로드, 인라인 data URI는 이미지와 영상 엔드포인트에서 같은 상한과 같은 접수 검사 아래 똑같이 동작합니다.

재시도는 새 작업을 만들고 옛 작업은 건드리지 않습니다

POST /api/v1/jobs/retry는 실패하거나 만료된 작업에서 새 작업을 만들고 스키마·가격·권한·이용 가능 여부를 다시 평가합니다. 원본 레코드는 그대로 남습니다.

상태 기계 하나로 전체가 커버됩니다

queued, running, succeeded, failed, expired. 이 다섯 단어가 모든 미디어 엔드포인트를 설명하므로 전이 로직은 한 번만 쓰면 됩니다.

출시 전

확인해 둘 플랫폼 동작

참조 비율을 출력 비율에 맞추는 일은 지원 티켓이 아니라 출시 전에 끝내세요.
참조는 제출 순간뿐 아니라 작업이 끝날 때까지 접근 가능해야 합니다.
재시도에는 별도의 멱등 범위를 두세요. 재시도는 재전송이 아니라 새 작업입니다.
새 키에 반드시 필요한 일일 상한에 영상 요율을 반영하세요.

자주 묻는 질문

이 페이지에서 자주 나오는 질문

그것은 여러분의 판단이자 법적 책임입니다. 플랫폼은 업로드의 신원을 검사하지 않으며, 약관은 동의와 권리를 고객 쪽에 둡니다.

모델

이 작업에 바로 호출할 수 있는 모델

각 링크는 해당 모델 계열 페이지로 이동합니다. 입력, 상한, 콘텐츠 방침, 단위당 현재 가격을 그곳에서 확인할 수 있습니다.

AlibabaWan 3.0이미지→영상콘텐츠 정책: 무검열 ByteDanceSeedance 2.5레퍼런스→영상콘텐츠 정책: 무검열 KlingKling 3.0캐릭터 애니메이션콘텐츠 정책: 필터 적용 ByteDanceSeedance 2.5 Spicy이미지→영상콘텐츠 정책: 무검열 AlibabaWan 3.0 Prime레퍼런스→영상콘텐츠 정책: 무검열 KlingKling 2.6캐릭터 애니메이션콘텐츠 정책: 필터 적용

이미지-투-비디오 엔드포인트 시험해 보기

참조 이미지를 짧은 영상으로. 첫 프레임 품질, 비율 불일치, 모션 필드, 길이가 결과와 가격에 미치는 영향.

이 작업의 모델 가격 비용 계산기