Pixverse Edit API

Pixverse Edit 소개

한 모델에 6가지 비디오 변환이 가능하다: 프롬프트 편집, 스타일링 변경, 피사 전환, 모션 전송, 업스케일링, 생성 효과음.

Pixverse Edit 사양

모델 ID

pixverse-edit

개발사

PixVerse

카테고리

영상 생성

출시

-

입력

텍스트비디오이미지

출력

비디오

엔드포인트

POST/v1/videos/generations

대체 모델 ID

pixverse/edit

Pixverse Edit API 요금

EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.

Pixverse Edit API 호출 방법

Pixverse Edit은(는) POST /v1/videos/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. EmpirioLabs 대시보드에서 API 키를 발급받으세요.

curl https://api.empiriolabs.ai/v1/videos/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-edit",
    "prompt": "Describe what you want Pixverse Edit to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/videos/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "pixverse-edit",
        "prompt": "Describe what you want Pixverse Edit to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

Pixverse Edit API 파라미터

EmpirioLabs에서 Pixverse Edit API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

알아두면 좋은 점

기존 영상을 mode으로 선택한 새 영상을 반환하는 여섯 가지 변신. 모드 - modify: 텍스트 프롬프트에서 클립 내용을 편집할 수 있으며, 최대 3개의 참조 이미지로 선택적으로 안내됩니다. - restyle: 움직임과 구도를 유지하면서 시각적 스타일을 변경합니다. restyle_prompt나 restyle_id 패스하세요. - swap: 클립 내 주제를 업로드된 이미지로 대체합니다. 모델은 선택한 키프레임 내 피사체를 감지합니다; swap_target 사용해 어떤 대상인지 명명하고, 그렇지 않으면 처음 감지된 대상을 사용하세요. - mimic: 원본 비디오의 움직임을 피사체 이미지에 전송합니다. - upscale: 클립의 해상도를 올리기. - sound_effect: 동기화된 사운드 베드를 생성합니다. 프롬프트는 비워서 영상에서 파생되도록 하고, modify 0__ 기존 오디오를 유지하도록 설정하세요. 출력 modify 1__, modify 2__, modify 3__ 360p, 540p 또는 720p 출력. modify 4__, modify 5__, modify 6__ 원본 클립을 따라갑니다. 청구 - 원본 비디오의 초당 요금으로 모드와 해상도에 따라 청구됩니다. modify 7__ 또한 해당 요청에 대해 청구된 초 단위로 소액의 단일 피사체 탐지 요금이 포함되어 있습니다. 입력 제한 - 비디오: MP4, MOV 또는 WebM, 긴 가장자리에서 최대 1920px, 30초. 수정, 모방, 교환, 업스케일에 최대 100MB, 스타일 변경과 사운드 효과에 50MB까지 사용할 수 있습니다. 스왑은 H.264 또는 H.265가 필요합니다. - 이미지: PNG, JPEG 또는 WebP, 최대 20MB와 긴 가장자리에 10000px.

Pixverse Edit API: 자주 묻는 질문

Pixverse Edit API 비용은 얼마인가요?

EmpirioLabs에서 Pixverse Edit은(는) 종량제로 청구됩니다: 360p 수정 $0.040889 초당; 540p 수정 $0.051111 초당; 720p 수정 $0.061333 초당; 스타일 변경 $0.051111 초당; 모션 컨트롤 360p $0.046 초당; 모션 컨트롤 540p $0.051111 초당; 모션 컨트롤 720p $0.061333 초당; 360p 스왑 $0.046 초당; 540p 스왑 $0.046 초당; 720p 스왑 $0.061333 초당; 고급 $0.025556 초당; 효과음 $0.010222 초당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.

Pixverse Edit은(는) 어떤 엔드포인트를 사용하나요?

Pixverse Edit은(는) api.empiriolabs.ai의 POST /v1/videos/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.

통합하기 전에 브라우저에서 Pixverse Edit을(를) 사용해 볼 수 있나요?

네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Pixverse Edit을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.

Pixverse Edit API 키는 어떻게 발급받나요?

EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.