PixVerse V6

PixVerse V6는 PixVerse의 동영상 모델입니다. 하나의 모델 ID로 텍스트로 동영상 생성, 이미지로 동영상 생성, 첫 프레임과 마지막 프레임 사이의 전환, 여러 이미지 참조, 이전에 만든 클립 연장의 다섯 모드를 지원합니다. 보내는 필드에 따라 모드가 정해집니다. 클립은 360p, 540p, 720p 또는 1080p의 1~15초이며, 네이티브 오디오는 선택 사항입니다. 요청을 보내고, 반환된 태스크 ID를 보관한 뒤, 완성된 동영상을 태스크에서 읽어 오세요. 이미지는 URL로 전달합니다.

모델 ID

현재 가격은 모델 페이지에서 확인하세요. 텍스트나 이미지 한 장으로 디테일이 더 풍부한 단일 샷을 만들려면 PixVerse V6 Max를 보세요.

간단한 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "540p",
    "duration": 5,
    "size": "16:9"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/videos/generations

응답은 완성된 동영상이 아니라 태스크({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요.

파라미터

스키마는 엄격합니다. 알 수 없는 필드는 무시되지 않고 거부됩니다. callback_url은 사용할 수 없으니 태스크를 폴링하세요.

모드

보내는 필드에 따라 모드가 정해집니다. 요청 한 번에 한 모드의 필드를 보내세요.

{
  "model": "pixverse-v6",
  "prompt": "The puppy slowly turns into a kitten, soft studio light.",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/kitten.jpg",
  "duration": 5
}

{
  "model": "pixverse-v6",
  "prompt": "The paper boat drifts on toward a lily pad.",
  "extend_from_task_id": "task_...",
  "resolution": "540p",
  "duration": 5
}

연장은 원본 클립 뒤에 새로운 구간이 이어진 결과를 반환하며, 새 구간의 duration에 대해서만 과금합니다. 저희 테스트에서 1초 클립을 1초 연장한 결과는 2.1초였으며 1초로 과금되었습니다.

미디어 입력

이미지는 공개 HTTP(S) URL입니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. 20 MB 이하의 JPG, PNG 또는 WebP 이미지를 사용하세요.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. PixVerse V6는 동영상 초 단위로 과금되며, 요율은 해상도와 오디오 생성 여부로 정해집니다:

cost = duration × rate per second for the resolution and audio setting

모든 모드의 초당 비용은 같으며, 연장은 새로운 구간에 대해서만 과금됩니다. 길이는 요청이 접수될 때 확정되므로, 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 태스크는 과금되지 않습니다.

출력 스키마

제출하면 태스크가 반환됩니다:

{"id": "task_...", "model": "pixverse-v6", "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",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689640,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

저희 테스트에서 1초 360p 16:9 클립은 640 × 360 MP4(H.264)로 제출 후 36~45초 만에 도착했습니다.

오류

태스크가 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 태스크는 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

{
  "id": "task_...",
  "model": "pixverse-v6",
  "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로 렌더링하세요.
• 세로 동영상은 텍스트로 동영상을 생성할 때 size: "9:16" 또는 세로 이미지를 보내세요.
• 지어낸 표시가 들어가지 않도록 no text, no logos를 추가하세요.

관련 자료

• PixVerse V6 Playground와 가격
• PixVerse V6 Max API 레퍼런스
• OpenAPI 다운로드
• 복사 가능한 Markdown