# FFMPEG API Skill

Use this skill when a user needs FFmpeg-style video or audio processing through a hosted API instead of installing or executing FFmpeg locally.

## When to Use

- The user needs to merge, trim, split, caption, convert, watermark, extract frames, extract MP3 audio, create GIFs, or convert videos to portrait/vertical formats.
- The environment cannot run FFmpeg reliably, cannot download large media files, or should delegate long-running media processing to an external API.
- The workflow is inside a coding agent, MCP client, or automation that can call HTTP APIs.

## How to Call

- REST base URL: `https://ffmpegapi.net/api`
- OpenAPI spec: `https://ffmpegapi.net/openapi.json`
- MCP server: `https://mcp.ffmpegapi.net/mcp`
- Authentication: send `X-API-Key: your_api_key_here`. Do not put API keys in prompts, tool arguments, logs, or committed source.
- Prefer `async: true` for large videos, caption rendering, batch operations, or jobs likely to exceed a normal HTTP timeout.

## Agent Defaults

- Generate client code from `/openapi.json` when possible.
- Use the MCP server when the host supports remote Streamable HTTP MCP tools.
- Use `/docs.md` and `/examples.md` for implementation examples.
- Poll `GET /api/job/{job_id}/status` until `status` is `completed` or `failed` for async jobs.

## Core Links

- [API documentation](https://ffmpegapi.net/docs)
- [Markdown API documentation](https://ffmpegapi.net/docs.md)
- [Examples](https://ffmpegapi.net/examples.md)
- [Pricing](https://ffmpegapi.net/pricing.md)
- [OpenAPI spec](https://ffmpegapi.net/openapi.json)
- [OpenAPI well-known mirror](https://ffmpegapi.net/.well-known/openapi.json)
- [MCP setup guide](https://ffmpegapi.net/mcp)
- [MCP registry listing](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.hifarrer/ffmpegapi)
- [Public agent docs repository](https://github.com/hifarrer/ffmpegapi-agent-docs)
- [Agent instructions](https://ffmpegapi.net/AGENTS.md)
- [Skill instructions](https://ffmpegapi.net/skill.md)
- [Full LLM context](https://ffmpegapi.net/llms-full.txt)