Pixverse Edit API

Pixverse Edit 소개

Six video transformations in one model: prompt editing, restyling, subject swap, motion transfer, upscaling, and generated sound effects.

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가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

알아두면 좋은 점

Six transformations that take an existing video and return a new one, selected with mode.

Modes

• modify: edit the content of a clip from a text prompt, optionally guided by up to 3 reference images.
• restyle: change the visual style while preserving motion and composition. Pass a restyle_prompt or a restyle_id.
• swap: replace a subject in the clip with an uploaded image. The model detects the subjects in the chosen keyframe; use swap_target to name which one, otherwise the first detected subject is used.
• mimic: transfer the motion of the source video onto a subject image.
• upscale: raise the resolution of the clip.
• sound_effect: generate a synchronized sound bed. Leave the prompt empty to have it derived from the video, and set original_sound_switch to keep the existing audio.

출력

• modify, mimic and swap output 360p, 540p or 720p. restyle, upscale and sound_effect follow the source clip.

Billing

• Billed per second of the source video at the rate for the mode and resolution. swap also includes a small one-off subject-detection charge, which is folded into the billed seconds for that request.

Input limits

• Video: MP4, MOV or WebM, up to 1920px on the long edge and 30 seconds. Up to 100MB for modify, mimic, swap and upscale, and 50MB for restyle and sound effects. Swap requires H.264 or H.265.
• Images: PNG, JPEG or WebP, up to 20MB and 10000px on the long edge.

Pixverse Edit API: 자주 묻는 질문

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

EmpirioLabs에서 Pixverse Edit은(는) 종량제로 청구됩니다: Modify 360p $0.16 per second; Modify 540p $0.20 per second; Modify 720p $0.24 per second. 이 페이지의 실시간 요금표는 항상 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에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.