
한 모델에 6가지 비디오 변환이 가능하다: 프롬프트 편집, 스타일링 변경, 피사 전환, 모션 전송, 업스케일링, 생성 효과음.
한 모델에 6가지 비디오 변환이 가능하다: 프롬프트 편집, 스타일링 변경, 피사 전환, 모션 전송, 업스케일링, 생성 효과음.
pixverse-edit/v1/videos/generationspixverse/editEmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 주간 사용량이 포함된 요금제를 선택할 수도 있습니다.
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)EmpirioLabs에서 Pixverse Edit API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| mode | enum | modify | modify, restyle, swap, mimic, upscale, sound_effect | 어떤 변신을 해야 할지. 프롬프트에서 내용을 수정하세요. 스타일 변경은 시각적 스타일을 바꿉니다. 스왑은 업로드된 이미지로 주제를 대체하는 기능입니다. Mimic은 그 움직임을 피사체 이미지에 전송합니다. 업스케일이 해상도를 높입니다. sound_effect 동기화된 사운드 베드를 생성합니다. |
| prompt | string | - | - | Modify는 편집 작업으로, Restyle은 타겟 스타일, sound_effect는 생성할 사운드로 사용됩니다. sound_effect에서 비워 두면 영상에서 소리를 얻을 수 있습니다. |
| resolution | enum | 540p | 360p, 540p, 720p | 수정, 모방, 스왑을 위한 출력 해상도. 스타일을 바꾸고, 업스케일링하며, 원본 클립을 따라 sound_effect 하세요. |
| restyle_id | number | - | - | 스타일 변경 시 스타일 프롬프트 대신 선택 가능한 사전 설정 id가 있습니다. |
| swap_target | string | - | - | 교체 모드에서 교체할 대상의 이름, 예를 들어 사람이나 개. 키프레임에서 처음 발견되는 주제로 기본값이 적용됩니다. |
| keyframe_id | number | 1 | 최소 1 | 소스 비디오 스왑 모드의 어떤 프레임이 피사체를 읽는지. 기본값은 첫 번째 프레임입니다. |
| original_sound_switch | boolean | false | - | 소스 클립 오디오를 생성된 효과음 아래에 두세요. |
| seed | number | - | 0 ~ 2147483647 | 재현성 씨앗을 재현해 스타일 재현을 위한 씨앗. |
| video | string | - | - | 원본 영상 URL. 모든 모드에 필수입니다. |
| image | string | - | - | 교체용 이미지 교체, 모방용 피사체 이미지, 또는 최대 3개의 가이드 이미지를 수정할 수 있습니다. |
기존 영상을 mode으로 선택한 새 영상을 반환하는 여섯 가지 변신.
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은(는) 360p, 540p, 720p을(를) 지원합니다. 기본값은 540p이며, 해상도별 제한은 파라미터 레퍼런스에서 확인할 수 있습니다.
Pixverse Edit은(는) api.empiriolabs.ai의 POST /v1/videos/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
요청의 model 값으로 pixverse-edit을(를) 보내세요. 대체 ID pixverse/edit도 사용할 수 있습니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Pixverse Edit을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다. 주간 사용량이 포함된 요금제를 선택할 수도 있습니다.