HunyuanVideo 1.5 API

tencent/hunyuan-video-1.5/image-to-video18크레딧부터 / 5초 영상· 이미지로 영상 만들기

HunyuanVideo 1.5는 Tencent의 오픈 83억 파라미터 영상 모델이에요. 프롬프트나 사진 한 장을 480p나 720p, 가로 또는 세로의 5초나 8초 클립으로 만들고, 얼굴, 피부, 옷감이 자연스럽게 나와요. 텍스트→영상은 네거티브 프롬프트도 받아요.

POST /jobs/createTask에서 모델 이름을 tencent/hunyuan-video-1.5/image-to-video(으)로 지정하면 호출할 수 있습니다. 18크레딧/ 5초 영상부터(US$0.18). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

  • 동영상 만들기
  • 이미지로 영상 만들기
  • 최대 720p
  • 5–8초

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
duration_seconds아니요클립 길이. 초 단위로 요금이 붙습니다. 5 · 8 · 기본값: 5
image_url예출발점이 되는 이미지.
prompt아니요Optional: describe the motion and the camera. Leave it empty to let the model animate the frame on its own.
resolution아니요출력 크기. 클수록 선명하고 가격도 올라갑니다. 480p · 720p · 기본값: 720p
seed아니요같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /초≈ USD
resolution 480p3.6US$0.036
resolution 720p7.2US$0.072

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

HunyuanVideo 1.5 API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 tencent/hunyuan-video-1.5/image-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tencent/hunyuan-video-1.5/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

HunyuanVideo 1.5 API 질문

HunyuanVideo 1.5 API 요금은 얼마인가요?

HunyuanVideo 1.5 가격은 가장 저렴한 이미지로 영상 만들기 기준 18크레딧(US$0.18) / 5초 영상부터입니다. 옵션별 가격: 480p 3.6크레딧/초, 720p 7.2크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 HunyuanVideo 1.5의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 동영상 만들기: tencent/hunyuan-video-1.5/text-to-video; 이미지로 영상 만들기: tencent/hunyuan-video-1.5/image-to-video을(를) 넣으세요.

HunyuanVideo 1.5는 무엇인가요?

Tencent Hunyuan 팀이 2025년 11월에 공개한 오픈 동영상 모델입니다. Tencent는 이를 3D 인과적 VAE와, 영상에서 불필요한 부분을 건너뛰는 어텐션 방식을 갖춘 83억 파라미터 디퓨전 트랜스포머로 설명하며, 일반 소비자용 GPU에서 돌아가도록 설계되었다고 밝힙니다.

클립은 얼마나 길고 얼마나 큰가요?

24fps의 5초 또는 8초이며 480p 또는 720p입니다. 텍스트→동영상은 832 x 480, 480 x 832, 1280 x 720, 720 x 1280 중에서 나오고, 이미지→동영상은 사진의 형태를 유지합니다.

소리도 만들어 주나요?

아니요. 클립은 오디오 트랙이 없는 무음 MP4 파일입니다. 소리는 직접 편집해서 넣거나, 영상과 함께 오디오를 생성하는 모델을 고르십시오.

이미지→동영상에 프롬프트가 꼭 필요한가요?

아니요. 이 엔드포인트에서 프롬프트는 선택이며, 없으면 모델이 사진을 알아서 움직입니다. 쓸 때는 사진 자체가 아니라 움직임과 카메라를 묘사하십시오.

클립 하나에 얼마나 걸리나요?

저희 테스트에서 5초 480p 클립은 모델 시간으로 약 1분에서 2분 30초, 5초 720p 클립은 약 2분 30초에서 4분이 걸렸습니다.

HunyuanVideo 1.5 API의 제한은 무엇인가요?

영상 길이: 5–8 s; 해상도: 480p · 720p. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 HunyuanVideo 1.5을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 HunyuanVideo 1.5을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

HunyuanVideo 1.5 더 알아보기