PixVerse
PixVerse V6 Max
pixverse-v6-max/image-to-video
PixVerse 플래그십 비디오 모델로, 텍스트→비디오와 이미지→비디오를 지원하며 1회 최대 15초, 최고 1080p, 배경 음악·효과음·대사 생성 옵션을 제공하여 광고 영상과 콘셉트 영상 제작에 적합합니다
pixverse-v6-max/image-to-video 사용해 보기
입력
작품 갤러리
모든 작품 보기출력
video가격
pixverse-v6-max/image-to-video per second
개요
이 모델은 이미지-투-비디오 생성 모델로, 공개 이미지 한 장을 첫 프레임으로 입력받아 프롬프트에 기술된 움직임과 분위기에 따라 동적 비디오를 생성합니다. 출력 비디오의 종횡비는 첫 프레임 이미지를 따르며, 해상도는 360p에서 1080p 사이에서 선택할 수 있고, 길이는 1초에서 15초로 설정할 수 있습니다. 개발자는 카메라 무빙, 피사체 동작, 분위기 묘사를 통해 완성 영상의 효과를 제어할 수 있어, 정적인 시각 자료를 숏폼 비디오 클립, 동적 포스터, 내러티브 샷으로 전환하는 데 적합하며 마케팅 전시, 콘텐츠 제작, 콘셉트 프리비즈에 활용됩니다.
핵심 특징
- 첫 프레임 기반, 종횡비 자동 추종——공개 이미지 한 장을 첫 프레임으로 제공하기만 하면 출력 비디오의 종횡비가 해당 이미지와 일치합니다.
- 길이와 해상도 선택 가능——비디오 길이는 1초에서 15초 사이로 설정할 수 있으며, 해상도는 360p, 540p, 720p 또는 1080p 중 선택할 수 있습니다.
- 프롬프트로 움직임과 분위기 제어——프롬프트로 화면의 움직임 방향과 전반적인 분위기를 묘사하여 정적인 첫 프레임을 동적 클립으로 유도합니다.
- 랜덤 시드로 유사 결과 재현——0에서 2147483647 사이의 랜덤 시드를 설정하고 동일한 프롬프트와 첫 프레임을 결합하면 유사한 효과를 재현할 수 있습니다.
기능 설명
이미지 첫 프레임으로 비디오 생성: JPEG, PNG 또는 WebP 이미지의 공개 링크를 첫 프레임으로 입력하고 텍스트 프롬프트와 결합하여 동적 비디오를 생성하며, 출력 종횡비는 첫 프레임 이미지를 따릅니다.
길이 및 해상도 설정: 1회 생성 시 비디오 길이는 1초에서 15초로 설정할 수 있고, 해상도는 360p, 540p, 720p, 1080p 중 하나를 선택할 수 있으며 기본값은 720p, 5초입니다.
프롬프트로 동적 효과 유도: 프롬프트는 최대 2048자이며, 첫 프레임 위의 움직임 방식과 분위기를 묘사하여 동적 표현을 제어하는 데 도움을 줍니다.
시드 제어로 재현: 동일한 랜덤 시드와 프롬프트를 설정하면 유사한 생성 결과를 재현할 수 있어 반복 작업에서 서로 다른 파라미터를 비교하기에 편리합니다.
적용 시나리오
- 정적 광고 이미지를 동적 클립으로——마케팅 팀이 제품 메인 이미지를 첫 프레임으로 삼고 움직임 프롬프트를 추가하여 15초 이내의 동적 전시 클립을 생성해 피드 광고나 소셜 미디어 게시에 활용합니다.
- 동적 포스터와 전시 소재——디자이너가 포스터나 시각 시안을 첫 프레임으로 하여 짧은 길이의 동적 버전을 생성해 웹 배너, 스플래시 화면, 전자 스크린 전시에 사용합니다.
- 콘셉트 화면 프리비즈——영화나 애니메이션 창작자가 콘셉트 아트를 첫 프레임으로 하고 카메라 무빙을 묘사하여 운동 프리비즈 클립을 빠르게 생성해 내부 커뮤니케이션과 방향 확정에 활용합니다.
- 소셜 미디어 숏폼 소재 제작——콘텐츠 크리에이터가 사진 이미지를 첫 프레임으로 하여 원본 비율에 맞는 숏폼 비디오를 생성해 소셜 플랫폼 숏폼 콘텐츠 게시에 사용합니다.
제한 사항 및 선택 가이드
첫 프레임 이미지는 한 장만 지원하며, 공개 접근 가능한 JPEG, PNG 또는 WebP 링크여야 하고 크기는 20MB를 초과할 수 없습니다. 여러 장의 참조 이미지 제공이나 마지막 프레임 별도 지정은 지원되지 않습니다. 프롬프트는 최대 2048자이며 초과 부분은 제출할 수 없습니다. 1회 생성 길이 상한은 15초이고 해상도는 최대 1080p입니다. 오디오 생성은 선택 스위치로 기본값은 꺼짐이며, 켜면 배경 음악, 효과음 또는 대사가 포함될 수 있고 끄면 출력 비디오에 오디오 트랙이 없습니다. 동일한 시드와 프롬프트는 유사한 결과만 재현할 수 있으며, 화면이 프레임 단위로 일치하거나 캐릭터가 완전히 동일함을 보장하지 않습니다.
새소식
변경 이력 보기 →- 새 모델 신규 모델 출시: PixVerse V6 Max 이미지→비디오
- 새 모델 신규 모델 출시: PixVerse V6 Max 텍스트-투-비디오
자주 묻는 질문
모든 질문 보기 →-
한 번에 최대 몇 초까지 생성할 수 있나요?
최대 15초이며, duration 파라미터는 1에서 15 사이의 정수 초 단위로 설정할 수 있고 기본값은 5초입니다. 초 단위로 과금되므로 모델을 선택할 때 세그먼트 길이를 호출 비용에 그대로 대응시키면 됩니다.
-
이미지로 영상 생성 시 참조 이미지를 한 번에 여러 장 전송할 수 있나요?
현재 다중 이미지 입력은 지원되지 않으며, image_urls는 공인 이미지 URL 1개만 허용되고 이는 영상의 첫 프레임으로 사용됩니다. JPEG, PNG, WebP를 지원하며 단일 이미지 최대 20 MB입니다. 출력 가로세로 비율은 이 이미지를 따르므로, 화면 비율을 바꾸려면 첫 프레임 이미지에서 처리해야 합니다.
-
최대 어떤 해상도까지 출력할 수 있나요?
최대 1080p이며, resolution은 360p, 540p, 720p, 1080p 중 선택할 수 있고 기본값은 720p입니다. 완성본 같은 품질이 필요할 때는 1080p로 설정하고, 미리보기나 저비용 시안 검증 시에는 낮은 단계로 동작과 구도를 확인하세요.
-
네이티브 오디오는 어떻게 켜고, 대사는 어떻게 작성하나요?
generate_audio를 true로 설정하면 모델이 배경 음악, 효과음, 대화를 함께 생성하며, 기본값은 꺼짐입니다. 대사는 prompt 안에 따옴표로 묶어 작성해야 합니다. 그렇지 않으면 읽어야 할 내용이 아니라 화면 묘사로 간주되기 쉽습니다.
생성 작업 제출
https://api.hiapi.ai/v1/tasks 헤더
Authorizationstring필수계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기
Content-Typestring선택요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.
Idempotency-Keystring선택멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.
네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.
본문
modelstring필수현재 고정 값: pixverse-v6-max/image-to-video
routestring선택현재 고정 값: default
inputobject필수
pixverse-v6-max/image-to-video 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.
seedinteger선택min 0max 2147483647랜덤 시드, 값 범위는 0에서 2147483647까지이며, 동일한 시드와 프롬프트로 유사한 생성 결과를 재현할 수 있습니다.
promptstring필수minLength 1maxLength 2048이미지에 추가할 움직임과 분위기를 설명하며, 최대 2048자입니다.
durationinteger선택기본값: 5min 1max 15비디오 길이(초), 값 범위는 1에서 15까지이며 초 단위로 과금됩니다; 기본값 5초.
image_urlsarray필수minItems 1maxItems 1첫 프레임 이미지 URL 배열로, 공개적으로 접근 가능한 이미지 주소 하나를 포함하며 JPEG, PNG 또는 WebP를 지원하고 최대 20 MB입니다; 출력 비디오는 해당 이미지의 가로세로 비율을 따릅니다.
Array [ string ]
resolutionstring선택기본값: "720p"출력 비디오 해상도; 기본값 720p.
360p540p720p1080pgenerate_audioboolean선택기본값: false비디오와 함께 배경 음악, 음향 효과 및 대사를 생성할지 여부; 대사를 생성하려면 대사를 prompt에 따옴표 형식으로 작성하세요; 기본값 false.
callbackobject선택
종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.
생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.
urlstring필수callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.
whenstring선택기본값: "final"현재는 final만 지원(success / fail 모두 알림).
finalstoragestring선택기본값: "temp"산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.
temppersistent요청 예시
# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6-max/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"generate_audio": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "pixverse-v6-max/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"generate_audio": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "pixverse-v6-max/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_urls": "…",
"resolution": "720p",
"generate_audio": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} 작업 상세 조회
https://api.hiapi.ai/v1/tasks/:id 응답 필드
taskIdstring필수태스크 ID. 접두사는 항상 tk-hiapi-.
modelstring필수확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.
routestring선택route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.
statusstring필수태스크 상태.
queued 대기 중, 아직 시작되지 않음.
handling 처리 중.
archiving 처리 완료, 산출물 준비 중.
success 종료: 완료. 산출물 사용 가능(output 반환).
fail 종료: 실패(error 반환).
제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.
creatednumber필수태스크 생성 시각(Unix 초).
completednumber필수종료 상태가 된 Unix 초. 비종료 상태에서는 0.
outputarray선택
status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).
Array [ object ]
배열 항목
urlstring필수산출물 URL. 바로 다운로드할 수 있습니다.
typestring필수현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.
expireAtnumber필수산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.
errorobject선택
status == fail일 때만 나타납니다.
codestring필수비즈니스 오류 코드.
messagestring필수오류 설명.
응답 예시
성공
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} 처리 중(비종료)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} 실패
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} 아티클
모든 아티클 보기 →관련 모델
모든 모델 보기 →동일 유형
-
HappyHorse 1.1 Alibaba $0.160 /초 -
MiniMax H3 MiniMax $0.072 /초 -
Grok Imagine 1.5 xAI $0.011 /초 -
Grok Imagine 1.5 Lite xAI $0.029 /초 -
Muse Video 1.0 Meta $0.034 /동영상 -
HeyGen Avatar IV HeyGen $0.150 /초 -
Gemini Omni 1.1 Google $0.450 /동영상 -
Vidu Q4 Preview Vidu $0.051 /초 -
Kandinsky 6.0 Pro $1.93 /동영상 -
Vidu Q3 Vidu $0.149 /초 -
Kling 4.0 Kuaishou $0.204 /초 -
Veo 3.1 Fast Google $0.170 /초


