---
canonical_url: "https://docs.composio.dev/toolkits/eranol"
markdown_url: "https://docs.composio.dev/toolkits/eranol.md"
product: "platform"
version: null
last_updated: null
---

# Eranol

Eranol provides API-driven video, audio, and media conversion workflows powered by FFmpeg.

- **Category:** video & audio
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `ERANOL`
- **Version:** 00000000_00

## Tools

### Caption Video

**Slug:** `ERANOL_CAPTION_VIDEO`

Transcribe a publicly downloadable video's audio, burn styled captions into the video, and produce subtitles. This asynchronous processing call consumes Eranol credits; the smallest live-tested media operation cost 10 credits, though captioning cost may vary. Generated outputs expire after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Optional language code. Omit this field to let Eranol auto-detect the spoken language. |
| `position` | string ("bottom" | "top" | "center") | No | Vertical caption position. |
| `font_size` | integer | No | Caption font size in pixels. |
| `video_url` | string | Yes | Publicly downloadable URL of the video to transcribe and caption. |
| `font_color` | string | No | Caption text color as a supported color name or hex value. |
| `padding_top` | integer | No | Top padding in pixels. |
| `outline_color` | string | No | Caption outline color as a supported color name or hex value. |
| `outline_width` | integer | No | Caption outline width in pixels. |
| `padding_bottom` | integer | No | Bottom padding in pixels. |
| `max_words_per_line` | integer | No | Maximum words in each rendered caption line. |
| `max_segment_duration` | number | No | Maximum subtitle segment duration in seconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Concatenate Videos

**Slug:** `ERANOL_CONCAT_VIDEOS`

Join two or more ordered, publicly downloadable video clips, optionally with one transition between clips. This asynchronous processing call consumes Eranol credits; observed processing cost at least 10 credits for a minimal conversion, while concat cost may vary. Generated output expires after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `clips` | array | Yes | Two or more public video clips to join. Each clip must have a unique order value. |
| `transition` | object | No | Optional transition applied between consecutive clips. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Convert Media

**Slug:** `ERANOL_CONVERT_MEDIA`

Convert a publicly downloadable media URL to MP3, WAV, JPG, WebP, MP4, or WebM using one fixed route selected by output_format. This asynchronous processing call consumes Eranol credits; the smallest live-tested conversion cost 10 credits, though cost may vary. Generated outputs expire after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_url` | string | Yes | Publicly downloadable URL of audio for MP3/WAV, an image for JPG/WebP, or video for MP4/WebM. |
| `output_format` | string ("mp3" | "wav" | "jpg" | "webp" | "mp4" | "webm") | Yes | Target format. This selects the fixed Eranol conversion route and determines whether the source must be audio, an image, or video. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Job

**Slug:** `ERANOL_DELETE_JOB`

Cancel or delete an Eranol media job and remove its generated output immediately.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Job ID to cancel or permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enhance Audio

**Slug:** `ERANOL_ENHANCE_AUDIO`

Enhance speech in publicly downloadable audio or video with noise reduction, voice profiling, optional loudness normalization, and output-format controls. This processing call consumes Eranol credits; the smallest live-tested Eranol processing request cost 10 credits, though enhancement cost may vary. Generated outputs expire after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_url` | string | Yes | Publicly downloadable audio or video URL containing speech to enhance. |
| `keep_video` | boolean | No | Whether to preserve the source video stream when media_url is a video. |
| `post_filter` | boolean | No | Whether to apply Eranol's post-processing filter after enhancement. |
| `output_format` | string ("mp3" | "m4a" | "wav") | No | Audio format for the enhanced output. |
| `voice_profile` | string ("none" | "natural" | "deep" | "bright") | No | Voice tone profile to apply. |
| `loudness_target` | number | No | Optional loudness target from -31 to -5 LUFS. Use null to leave loudness normalization disabled. |
| `attenuation_limit_db` | number | No | Maximum noise attenuation in decibels, from 0 to 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Credits

**Slug:** `ERANOL_GET_ACCOUNT_CREDITS`

Return the connected Eranol account ID and remaining processing credits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Result

**Slug:** `ERANOL_GET_JOB_RESULT`

Return a completed Eranol media job's download URL and output metadata, or its status and progress while still processing. Generated output URLs expire after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Completed job ID returned by an Eranol processing tool. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Status

**Slug:** `ERANOL_GET_JOB_STATUS`

Return an Eranol media job's state, progress, timestamps, error, and nested result metadata when available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Job ID returned by an Eranol processing tool. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trim Video

**Slug:** `ERANOL_TRIM_VIDEO`

Create a losslessly trimmed clip from a publicly downloadable video URL and start/end times. This asynchronous processing call consumes Eranol credits; the smallest live-tested media operation cost 10 credits, though trim cost may vary. Generated output files expire after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_url` | string | Yes | Publicly downloadable URL of the source video. |
| `end_seconds` | number | Yes | End time in seconds; must be greater than start_seconds. |
| `start_seconds` | number | Yes | Start time in seconds from the beginning of the video. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Watermark Video

**Slug:** `ERANOL_WATERMARK_VIDEO`

Add an image watermark to a publicly downloadable video with position, margin, opacity, and scale controls. This asynchronous processing call consumes Eranol credits; the smallest live-tested processing request cost 10 credits, though cost may vary. Generated output expires after 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scale` | number | No | Watermark size relative to the video, from 0.01 to 1. |
| `margin` | integer | No | Margin from the selected edges in pixels, from 0 to 500. |
| `opacity` | number | No | Watermark opacity from 0 (transparent) to 1 (opaque). |
| `position` | string ("top_left" | "top_right" | "top_center" | "bottom_left" | "bottom_right" | "bottom_center" | "center") | No | Watermark placement on the video. |
| `video_url` | string | Yes | Publicly downloadable URL of the source video. |
| `watermark_url` | string | Yes | Publicly downloadable URL of the watermark image. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |