Fal.AI를 통해 제공되는 Sonilo v1.1 비디오-투-사운드이펙트 모델입니다. 입력 영상에 AI가 생성한 사운드(환경음, 효과음, 폴리)를 추가합니다. 프롬프트가 없으면 장면을 자동으로 캡션 처리하고, 구간별 사운드 설명을 제공하면 더 세밀한 제어가 가능합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "sonilo/v1.1/video-to-sound-effects",
"input": {
"video_url": "https://storage.googleapis.com/falserverless/model_tests/video_models/mmaudio_input.mp4",
"audio_format": "aac"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | No | - | 선택 항목입니다. 원하는 사운드의 종류를 설명하면 모든 장면에서 생성되는 오디오에 반영됩니다. 비워두면 영상을 자동으로 캡션 처리합니다. |
video_url | string | Yes | - | 사운드를 추가할 영상입니다 (공개 URL 또는 파일 업로드). 생성되는 오디오는 영상 길이에 맞춰집니다. |
segments | array | No | - | 선택 항목입니다. 영상을 시간 구간으로 나누고 각 구간마다 별도의 사운드 설명을 지정할 수 있습니다. 비워두면 장면 단위로 자동 분할됩니다. |
audio_format | string | No | aac | 반환되는 오디오 파일의 형식입니다: aac(기본값), mp3, wav, flac 중 선택. (사운드가 입혀진 영상 파일 자체는 항상 AAC입니다.) wavmp3aacflac |
이 모델의 video_url 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=sonilo/v1.1/video-to-sound-effects" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:video_url=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "sonilo/v1.1/video-to-sound-effects",
"input": {
"prompt": "your prompt here",
"video_url": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
별도의 프롬프트 없이 무음 영상에 자동으로 생성된 환경음과 효과음을 추가합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "sonilo/v1.1/video-to-sound-effects",
"input": {
"video_url": "https://storage.googleapis.com/falserverless/model_tests/video_models/mmaudio_input.mp4",
"audio_format": "aac"
}
}'명시적인 프롬프트로 사운드 디자인 방향을 지정하고, 별도 오디오 트랙을 WAV 형식으로 요청합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "sonilo/v1.1/video-to-sound-effects",
"input": {
"video_url": "https://example.com/city-street-timelapse.mp4",
"prompt": "Busy city street ambience with distant traffic, footsteps, and occasional car horns.",
"audio_format": "wav"
}
}'