# Sonilo v1.1 Video to Sound Effects

> Sonilo v1.1 video-to-sound-effects via Fal.AI. Adds AI-generated sound (ambience, effects, foley) to an input video — auto-captions the scene if no prompt is given, or accepts per-segment sound descriptions for finer control.

- **Provider**: fal
- **Model ID**: sonilo/v1.1/video-to-sound-effects
- **Category**: music_generation
- **Credits**: 310 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `audio_format` (string, optional): Format of the returned audio file: aac (default), mp3, wav, or flac. (The video with sound is always AAC.) (Default: `aac`; Options: `wav`, `mp3`, `aac`, `flac`)
- `video_url` (string, **required**): The video to add sound to (public URL, or upload a file). The generated audio matches the video's length.
- `prompt` (string, optional): Optional. Describe the kind of sound you want; it steers the generated audio for every scene. Leave empty to caption the video automatically.
- `segments` (array, optional): Optional. Split the video into time ranges, each with its own sound description. Leave empty to split into scenes automatically.

## Example Request

```json
{
  "model": "sonilo/v1.1/video-to-sound-effects",
  "input": {
    "audio_format": "aac",
    "video_url": "https://storage.googleapis.com/falserverless/model_tests/video_models/mmaudio_input.mp4"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

sound-effects, video-to-audio, foley, sonilo

## Documentation

https://fal.ai/models/sonilo/v1.1/video-to-sound-effects