Video
PixVerse V6 Max
PixVerse V6 Max로 프롬프트나 이미지 한 장에서 360p~1080p의 1~15초 클립을 생성하세요. 오디오는 선택 사항이며, 초 단위로 과금되고 태스크로 전달됩니다.
PixVerse V6 Max는 PixVerse V6보다 디테일이 더 풍부한 버전입니다. 프롬프트, 또는 시작 이미지 한 장과 선택 사항인 프롬프트로 360p, 540p, 720p 또는 1080p의 1~15초 클립을 만들며, 네이티브 오디오는 선택 사항입니다. 요청을 보내고, 반환된 태스크 ID를 보관한 뒤, 완성된 동영상을 태스크에서 읽어 오세요. 이미지는 URL로 전달합니다.
모델 ID
| 모델 ID | 입력 | 해상도 | 길이 |
|---|---|---|---|
pixverse-v6-max | 텍스트, 이미지 한 장 | 360p, 540p, 720p, 1080p | 1~15초 |
현재 가격은 모델 페이지에서 확인하세요. 전환, 여러 이미지 참조, 연장은 PixVerse V6의 기능입니다.
간단한 예제
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6-max",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'엔드포인트
POST https://api.seedrouter.ai/v1/videos/generations| 헤더 | 값 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
응답은 완성된 동영상이 아니라 태스크({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요.
파라미터
| 필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
model | string | 필수 | pixverse-v6-max |
prompt | string | 설명 참고 | 텍스트로 동영상 생성: 필수, 최대 5,000자. 이미지가 있으면 선택 사항, 최대 2,048자. |
image_urls | URL 목록 | 없음 | 이미지로 동영상 생성: 정확히 한 장. 없으면 텍스트로 동영상 생성입니다. |
resolution | enum | 540p | 360p, 540p, 720p 또는 1080p. |
quality | enum | 없음 | resolution의 별칭으로, 값은 같습니다. 둘 다 보내면 resolution이 우선합니다. |
duration | integer | 5 | 1~15초. |
aspect_ratio | enum | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 또는 21:9. 텍스트로 동영상 생성에서만 사용하며, 이미지가 있으면 클립이 이미지의 화면 형태를 따릅니다. |
audio | boolean | false | 네이티브 오디오를 생성합니다. 오디오 포함 요율로 과금됩니다. |
seed | integer | 없음 | 0~2147483647. 같은 요청과 시드는 비슷한 결과를 만듭니다. |
스키마는 엄격합니다. 알 수 없는 필드는 무시되지 않고 거부됩니다. first_frame_image, last_frame_image, img_references, extend_from_task_id는 pixverse-v6를 안내하는 400 오류를 반환합니다. callback_url은 사용할 수 없으니 태스크를 폴링하세요.
이미지로 동영상 생성
image_urls에 이미지 한 장을 넣으세요. 클립은 그 이미지로 시작하며 이미지의 화면 형태를 유지하므로, 세로 이미지를 넣으면 세로 클립이 됩니다. 이 경우 프롬프트는 선택 사항입니다.
{
"model": "pixverse-v6-max",
"prompt": "The subject slowly turns toward the camera, soft natural light.",
"image_urls": ["https://example.com/start.png"],
"resolution": "1080p",
"duration": 5
}미디어 입력
이미지는 공개 HTTP(S) URL입니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. 20 MB 이하이고 각 변이 최대 10,000픽셀인 JPG, PNG 또는 WebP 이미지 한 장을 사용하세요.
과금에 영향을 주는 요소
현재 요율은 모델 가격 섹션에서 확인하세요. PixVerse V6 Max는 동영상 초 단위로 과금되며, 요율은 해상도와 오디오 생성 여부로 정해집니다:
cost = duration × rate per second for the resolution and audio setting텍스트로 동영상 생성과 이미지로 동영상 생성의 비용은 같습니다. 길이는 요청이 접수될 때 확정되므로, 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 태스크는 과금되지 않습니다.
출력 스키마
제출하면 태스크가 반환됩니다:
{"id": "task_...", "model": "pixverse-v6-max", "status": "processing", "created_at": 1789689600}태스크 조회
GET https://api.seedrouter.ai/v1/tasks/{task_id}status가 completed 또는 failed가 될 때까지 10~20초마다 폴링하세요. 폴링 중 네트워크 타임아웃이 났다고 생성이 실패한 것은 아닙니다. 태스크 ID를 보관하고 다시 확인하세요. 진행 상황을 보려고 태스크를 새로 만들지 마세요.
완료된 태스크
{
"id": "task_...",
"model": "pixverse-v6-max",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689690,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}저희 테스트에서 1초 360p 16:9 클립은 640 × 360 MP4(H.264)로 제출 후 81~89초 만에 도착했습니다.
오류
태스크가 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 태스크는 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.
코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.
{
"id": "task_...",
"model": "pixverse-v6-max",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}제출 자체가 타임아웃된 경우에는 다시 보내기 전에 태스크 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.
팁
- 프롬프트에 피사체, 장소, 카메라 움직임, 조명을 설명하고,
audio가 켜져 있으면 원하는 소리도 적으세요. 360p또는540p로 초안을 만든 뒤, 같은 요청과seed로 최종 샷을1080p로 렌더링하세요.- 세로 동영상은
aspect_ratio: "9:16"또는 세로 이미지를 보내세요. - 지어낸 표시가 들어가지 않도록
no text, no logos를 추가하세요.
