Claude Opus 5.5을(를) SeedRouter에서 사용할 수 있습니다

Video

PixVerse V6 Max

View Markdown

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, 1080p1~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
헤더값
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

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

파라미터

필드타입기본값설명
modelstring필수pixverse-v6-max
promptstring설명 참고텍스트로 동영상 생성: 필수, 최대 5,000자. 이미지가 있으면 선택 사항, 최대 2,048자.
image_urlsURL 목록없음이미지로 동영상 생성: 정확히 한 장. 없으면 텍스트로 동영상 생성입니다.
resolutionenum540p360p, 540p, 720p 또는 1080p.
qualityenum없음resolution의 별칭으로, 값은 같습니다. 둘 다 보내면 resolution이 우선합니다.
durationinteger51~15초.
aspect_ratioenum16:916:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 또는 21:9. 텍스트로 동영상 생성에서만 사용하며, 이미지가 있으면 클립이 이미지의 화면 형태를 따릅니다.
audiobooleanfalse네이티브 오디오를 생성합니다. 오디오 포함 요율로 과금됩니다.
seedinteger없음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를 추가하세요.

관련 자료