# Video Utils

> FFmpeg-powered video utilities (20M+ runs) — convert to mp4/gif, extract audio as mp3, or dump zipped frames, all with one task parameter.

- **Provider**: replicate
- **Model ID**: nicolascoutureau/video-utils
- **Category**: utilities
- **Credits**: 5 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

- `fps` (integer, optional): frames per second, if relevant. Use 0 to keep original fps (or use default). Converting to GIF defaults to 12fps (Default: `0`)
- `input_file` (string, **required**): File – zip, image or video to process
- `task` (string, **required**): Task to perform (Options: `convert_input_to_mp4`, `convert_input_to_gif`, `extract_video_audio_as_mp3`, `zipped_frames_to_mp4`, `zipped_frames_to_gif`, `extract_frames_from_input`, `reverse_video`, `bounce_video`, `create_image_preview`, `create_preview_video`, `get_video_metadata`, `reencode_audio_for_fast_seeking`, `encode_for_insta`, `reencode_for_web`)

## Example Request

```json
{
  "model": "nicolascoutureau/video-utils",
  "input": {
    "fps": 0,
    "input_file": "https://replicate.delivery/pbxt/Mr0wXFtyPY2zqhynFgNU7xMUhyhJsYja4gTSsJFZKf3Ev4vP/WCtrxBhe2SQ_wbgFI7Li-.mp4",
    "task": "create_preview_video"
  }
}
```

## 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-conversion, ffmpeg, gif, audio-extraction, utilities

## Documentation

https://replicate.com/nicolascoutureau/video-utils