
생성된 사운드트랙, 프레임 동기화 효과 또는 둘 다를 섞어 원본 영상을 그대로 돌려줍니다.
생성된 사운드트랙, 프레임 동기화 효과 또는 둘 다를 섞어 원본 영상을 그대로 돌려줍니다.
sonilo-video-to-video/v1/videos/generationssonilo-v2vsonilo/sonilo-video-to-videoEmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
Sonilo Video to Video은(는) 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": "sonilo-video-to-video",
"prompt": "Describe what you want Sonilo Video to Video 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": "sonilo-video-to-video",
"prompt": "Describe what you want Sonilo Video to Video 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에서 Sonilo Video to Video API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| mode | enum | music | music, effects, music_and_effects | 반환된 영상에 무엇을 추가할지: 생성된 사운드트랙, 프레임 동기화된 효과음, 혹은 둘 다를 섞어서 넣을까요? |
| prompt | string | - | - | 생성된 오디오에 대한 창의적인 방향 제시. |
| music_prompt | string | - | - | 음악 침대 방향. |
| sfx_prompt | string | - | - | 효과음 연출. |
| keep_original_sound | boolean | false | - | 생성된 오디오 아래에 원본 전체 오디오 트랙을 유지하세요. 이게 없으면 소스 오디오가 제거됩니다. |
| preserve_speech | boolean | false | - | 원본 전체 트랙이 아니라 원본의 단독 대사만 남겨두세요. |
| ducking | boolean | false | - | 정적인 믹스를 유지하지 말고 생성된 오디오 아래에 녹음된 목소리를 담가보세요. |
| variants_num | number | 1 | 1 ~ 10 | 한 요청에 몇 개의 서로 다른 점수를 받은 영상을 생성해야 할까요? 각 변형은 별도로 청구됩니다. |
| prompt_influence | number | 0.5 | 0 ~ 1 | 음악이 영상보다 프롬프트를 얼마나 강하게 따르는지. 아래쪽은 영상이 이끄는 방향으로 진행되도록 합니다. |
| segments | string | - | - | 장면별 방향에 맞는 타이밍 세그먼트 프롬프트의 JSON 배열입니다. 각 항목은 시작, 종료, 프롬프트를 초 단위로 처리합니다. |
| video_url | string | - | - | 소스 비디오는 공개적으로 접근 가능한 URL로 제공됩니다. 최대 300MB와 8분까지입니다. playground에 동영상을 업로드하면 이 기능이 자동으로 설정됩니다. |
모드 - 음악은 생성된 사운드트랙과 함께 음악을 반환 - 이펙트는 프레임 동기화 효과음으로 비디오를 반환 - music_and_effects 음악과 효과가 섞인 비디오를 반환함 컨트롤 모드, 소스 비디오, 창의적 방향, 사운드 모드 내 음악 및 효과 분리 프롬프트 지원, 원본 오디오, 음성 보존, 숙임, 음악 모드에서 10가지에서 10가지까지의 변형, 프롬프트 영향, JSON 세그먼트 프롬프트 유지. 제한 - 최대 300MB 8분 소스 비디오 - H.264, H.265, VP9 또는 AV1을 포함하는 mp4, mov, m4v 또는 webm 수신 - 원본 영상을 재인코딩 없이 복사하여 반환된 영상은 원래 해상도와 프레임 속도를 유지함 - 기본적으로 소스 오디오는 제거됨. 원본 사운드 유지로 모두 유지하거나, 음성 보존 상태로 음성 재생만 하세요 청구 - 생성된 초당 카탈로그 요금으로 요금이 부과되며, 음악 및 사운드 모드는 최소 10초, 효과음 모드는 최소 3초입니다. 각 변형은 별도로 청구됩니다. 생성 전에 요청이 거부되면 청구되지 않습니다.
EmpirioLabs에서 Sonilo Video to Video은(는) 종량제로 청구됩니다: 음악만 $0.018 초당; 효과만 $0.018 초당; 음악 및 효과 $0.0288 초당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
Sonilo Video to Video은(는) api.empiriolabs.ai의 POST /v1/videos/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Sonilo Video to Video을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.