소개
HunyuanVideo 1.5 텍스트→동영상은 글로 쓴 프롬프트를 짧은 클립으로 만듭니다. HunyuanVideo 1.5는 Tencent가 공개한 83억 파라미터 동영상 모델이며, 이 엔드포인트는 480p 또는 720p, 가로 또는 세로의 5초·8초 클립을 돌려주고 결함을 줄이는 네거티브 프롬프트도 지원합니다. 플랫폼은 프롬프트와 클립에 콘텐츠 필터를 더하지 않습니다.
시작 자료에 따라 모드 선택하기
| 가진 자료 | 모드 |
|---|---|
| 글로 쓴 설명 | HunyuanVideo 1.5 텍스트→동영상 |
| 움직일 사진 | HunyuanVideo 1.5 이미지→동영상 |
핵심 기능 및 하이라이트
작은 크기에서도 자연스러운 인물
모델은 83억 파라미터이지만, 저희 테스트에서 얼굴과 피부, 머리카락, 옷감이 사진처럼 보였고 뭉개지지 않고 움직였습니다.
네 가지 프레임 크기
aspect_ratio와 resolution을 조합하면 832 x 480, 480 x 832, 1280 x 720, 720 x 1280이 되므로, 세로 클립도 자르지 않고 화면에 맞춰 구성됩니다.
네거티브 프롬프트
절대 보고 싶지 않은 것을 적으십시오. 불필요한 글자, 뒤틀린 손, 흐림을 가장 빠르게 잡는 방법입니다.
무검열
프롬프트와 결과물에 필터가 없습니다. 저희 테스트에서 대부분의 콘텐츠 테스트는 적은 그대로 렌더링되었고, 가장 높은 수위에서는 장면의 일부를 덜 표현했습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 프레임에 누가 있는지, 무엇을 입고 무엇을 하는지, 카메라가 어떻게 움직이는지를 적으십시오. 클립 하나에 뚜렷한 동작 하나일 때 가장 잘 나옵니다. 1자 이상 |
negative_prompt | 아니요 | 클립에서 빼고 싶은 것의 선택 목록입니다. 예: ‘blurry, distorted hands, extra limbs, text, watermark’. |
aspect_ratio | 아니요 | 가로는 16:9(기본값), 세로는 9:16입니다. 화면 형태는 가격에 영향을 주지 않습니다. |
resolution | 아니요 | 480p(832 x 480) 또는 720p(1280 x 720, 기본값)입니다. 720p는 초당 요금이 두 배이니 시안은 480p로 잡으십시오. |
duration_seconds | 아니요 | 5초 또는 8초이며 초 단위로 과금됩니다. |
seed | 아니요 | 한 번에 하나씩만 바꾸는 동안 결과를 비교하기 쉽게 해 줍니다. 프레임 단위로 똑같은 클립을 보장하지는 않습니다. |
요금
선택한 해상도로 출력 초 단위로 과금됩니다. 화면비는 가격에 영향을 주지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.024 / 초 |
| $0.048 / 초 |
활용 사례
세로형 소셜 클립
피드와 스토리용 720 x 1280의 9:16입니다.
프롬프트 탐색
480p에서는 5초 시안이 저렴하므로, 아이디어를 키우기 전에 여러 프롬프트를 시험할 수 있습니다.
자체 플랫폼을 위한 필터 없는 클립
프롬프트와 클립에 콘텐츠 필터가 없으며, 화면에는 성인만 등장해야 합니다.
프롬프트 가이드 및 실전 팁
샷을 쓰십시오
피사체, 의상, 동작, 빛, 카메라 순으로 두세 문장에 담으십시오.
클립 하나에 동작 하나
5초는 제스처 하나나 움직임 하나를 담는 길이입니다. 동작을 이어 붙이면 서로 뭉개집니다.
접촉 장면은 단순하게
두 사람이 닿는 장면은 팔다리가 얽히기 쉬우니, 느린 움직임과 넓은 샷이 도움이 됩니다.
작게 시안을 잡으십시오
480p에서 seed를 고정해 아이디어를 돌려 보고, 가장 좋은 결과를 720p로 다시 돌리십시오.
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": "tencent/hunyuan-video-1.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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 레퍼런스에서 확인하세요.








