canonical: https://jentic.com/apis/eranol.com/eranol

# Eranol API

Jentic publishes the only available OpenAPI specification for the Eranol API, keeping it validated and agent-ready. Eranol wraps FFmpeg-based video and audio processing behind a REST surface, plus AI image generation and a TikTok publishing connector. The 34 endpoints cover format conversion (video, audio, image), video composition (intro, outro, concat, overlay, captions, progress bars, thumbnails), audio cleanup (denoise, remove silence, highlight extraction), job tracking, email notifications, and direct social publishing. Authentication is by X-API-Key header, and most operations are asynchronous, returning a job_id whose status is polled at /ffmpeg/status/{job_id}.

## For AI agents

Run server-side video editing, audio processing, format conversion, AI image generation, and TikTok publishing without managing FFmpeg infrastructure. Authenticate with an X-API-Key header.

## Scope

Does not handle live streaming, DRM-protected content, or YouTube and Instagram publishing - use for asynchronous video and audio processing plus TikTok publishing only.

## Capabilities

- Convert video, audio, and image files between formats including MP4, WebM, MP3, WAV, JPG, and WebP
- Compose videos by adding intros, outros, captions, overlays, and progress bars
- Concatenate or merge multiple video clips in a chosen order
- Clean audio with denoise and remove-silence operations and extract highlight segments
- Generate images with AI and poll job status for completed renders
- Extract thumbnails, GIFs, audio tracks, or frame images from a source video
- Publish finished video content to TikTok and check publish status

## Use cases

### Automated Short-Form Video Production Pipeline

Creator-facing tools assemble short-form videos from a script, AI images, stock footage, and a music bed. Eranol's compose, concat, overlay, captions, and add-bg-audio endpoints chain into a render pipeline that produces a TikTok-ready MP4 from raw inputs in minutes, with an X-API-Key as the only credential to manage.

Example prompt: Call POST /ffmpeg/video/concat with three clip URLs, then POST /ffmpeg/video/caption on the result, then POST /ffmpeg/video/add-bg-audio to add a music bed.

### Podcast Post-Production Audio Cleanup

Podcasters need denoising, silence trimming, and highlight extraction without running an FFmpeg toolchain locally. Eranol's /ffmpeg/audio/denoise, /ffmpeg/audio/remove-silence, and /ffmpeg/audio/highlights endpoints take a source URL and return a cleaned WAV plus a list of timestamp ranges flagged as highlight candidates.

Example prompt: Call POST /ffmpeg/audio/denoise with the recording URL, then POST /ffmpeg/audio/highlights on the cleaned output to retrieve the top three highlight segments.

### TikTok Auto-Publishing for a Content Studio

Studios that produce dozens of short videos a day need scheduled publishing without manual uploads. Eranol's /social/tiktok/publish endpoint accepts a finished video URL and posts it to the connected TikTok account, while /social/tiktok/status confirms whether the post landed, so an agent can complete the produce-then-publish loop.

Example prompt: Call POST /social/tiktok/publish with the rendered video URL and caption, then poll GET /social/tiktok/status until it reports posted.

### AI Agent Video Editor via Jentic

An AI editing assistant can be wired through Jentic to take a brief like 'make a 30-second highlight reel from these clips with captions and a progress bar'. The agent searches by intent, loads the relevant Eranol operations, and chains compose, captions, and progress-bar calls with the X-API-Key scoped from the vault - no FFmpeg infrastructure needed.

Example prompt: Use Jentic search('compose a video with captions and progress bar'), load the matching Eranol operations, and execute compose then caption then progress-bar in sequence.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /ffmpeg/video/concat | Concatenate videos in order |
| POST | /ffmpeg/video/caption | Generate captions from a video's audio |
| POST | /ffmpeg/video/overlay | Overlay text or images on video |
| POST | /ffmpeg/audio/denoise | Remove background noise from audio |
| POST | /image | Generate an image with AI |
| POST | /social/tiktok/publish | Publish a video to TikTok |
| GET | /ffmpeg/status/{job_id} | Get current job status |
| POST | /ffmpeg/convert/video/to/mp4 | Convert a video to MP4 |

## Key resources

- **Video** — Compose, concat, caption, overlay, reframe, thumbnail, and extract operations
- **Audio** — Denoise, remove silence, highlight extraction, and audio extraction from video
- **Conversion** — Format conversion between MP4, WebM, MP3, WAV, JPG, WebP
- **AI Image** — Generate images from text prompts and poll job status
- **Jobs** — Track asynchronous job status and delete completed outputs
- **Notifications** — Send email notifications about job completion
- **Social** — Publish to TikTok and check publish status

## Why Jentic

- **Setup:** Wiring Eranol by hand means handling its X-API-Key header auth, polling the status endpoint for asynchronous jobs, and building your own retries against ffmpeg.eranol.com. Through Jentic you install once, import the Eranol API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Eranol sends the media inputs in the request body rather than the URL, so scope the agent to the operations it needs, such as POST /ffmpeg/video/concat or GET /ffmpeg/status/{job_id}. You pick that allowed set, so an operation like POST /social/tiktok/publish is only reachable if you include it.
- **Credential handling:** Your Eranol X-API-Key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'concatenate videos' or 'denoise audio', and Jentic returns the matching Eranol operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Epidemic Sound Partner Content API** — Licensed music catalogue - pairs with Eranol to source music beds for video composition
- **EODHD Financial Data API** — Market data - useful for finance video content generation
- **Esendex Messaging API** — SMS notifications when a render or publish job completes

## FAQ

### Why is there no official OpenAPI spec for the Eranol API?

Eranol publishes documentation at eranol.com but does not provide a downloadable OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the Eranol API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Eranol API use?

Eranol uses an apiKey scheme passed in the X-API-Key header on every request. Through Jentic the key is stored encrypted in your Jentic One instance and injected at execution time so agents never see the raw value.

### Can I add captions to a video with the Eranol API?

Yes. POST /ffmpeg/video/caption generates captions from the audio track of the supplied video URL and returns a captioned MP4 once the job completes.

### What are the rate limits for the Eranol API?

Eranol does not document fixed HTTP rate limits in the spec; throughput is constrained by the render queue at ffmpeg.eranol.com and by your plan's concurrent-job allowance. Poll /ffmpeg/status/{job_id} to track queued work.

### How do I publish a finished video to TikTok through Jentic?

Search 'publish video to tiktok'. Jentic returns the POST /social/tiktok/publish operation, you load its schema, and execute with the rendered video URL and caption. The X-API-Key is injected from the vault.

### Are Eranol jobs synchronous or asynchronous?

Most rendering operations are asynchronous and return a job_id. Use GET /ffmpeg/status/{job_id} to poll progress and DELETE /ffmpeg/jobs/{job_id} to clean up the output once downloaded.

### Can I generate an image with AI through this API?

Yes. POST /image accepts a prompt and queues an AI image generation job; GET /image/status/{job_id} returns the rendered image URL once ready.

### Can I limit what my agent is allowed to do with the Eranol API?

Yes. Jentic One is self-hosted, so you run the instance and your own rules decide which Eranol operations and credentials the agent may use. Because Eranol passes media inputs in the request body rather than the URL, you scope by choosing the exact operation set the agent can call, such as POST /ffmpeg/video/concat and GET /ffmpeg/status/{job_id}. An operation like POST /social/tiktok/publish is only reachable if you include it in that allowed set, and the X-API-Key is injected at execution time so the agent never sees it.