# MMAudio

> Add AI-generated sound to any video (5M+ runs) — synthesizes synchronized audio (ambience, effects, foley) from the video content and an optional text prompt.

- **Provider**: replicate
- **Model ID**: zsxkib/mmaudio
- **Category**: video_editing
- **Credits**: 11 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

- `prompt` (string, optional): Text prompt for generated audio (Default: ``)
- `duration` (number, optional): Duration of output in seconds (Default: `8`; Range: min: 1)
- `negative_prompt` (string, optional): Negative prompt to avoid certain sounds (Default: `music`)
- `num_steps` (integer, optional): Number of inference steps (Default: `25`)
- `cfg_strength` (number, optional): Guidance strength (CFG) (Default: `4.5`; Range: min: 1)
- `video` (string, optional): Optional video file for video-to-audio generation
- `seed` (integer, optional): Random seed. Use -1 or leave blank to randomize the seed (Range: min: -1)
- `image` (string, optional): Optional image file for image-to-audio generation (experimental)

## Example Request

```json
{
  "model": "zsxkib/mmaudio",
  "input": {
    "duration": 8,
    "num_steps": 25,
    "seed": -1,
    "cfg_strength": 4.5,
    "negative_prompt": "music",
    "video": "https://huggingface.co/hkchengrex/MMAudio/resolve/main/examples/sora_galloping.mp4",
    "prompt": "galloping"
  }
}
```

## 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

url

## Tags

video-to-audio, sound-effects, foley, video-editing, mmaudio

## Documentation

https://replicate.com/zsxkib/mmaudio