Early Access·Send Feedback
Ambedo

Ambedo API

Programmatically process media files, extract metadata, and transcode content using our high-performance cloud infrastructure.

Overview

The Ambedo API is designed for developers who need to automate media workflows. All requests are served over HTTPS and return JSON responses.

Base URL
https://www.bulkmetadataeditor.com/api/v1

Authentication

Authentication is handled via API Keys. You can generate and manage your keys in the user dashboard.

  1. Log in to your Account Dashboard.
  2. Navigate to Settings → Cloud API Keys.
  3. Generate a new standard key (sk_live_...).

Header Format

http
X-API-Key: sk_live_dccff2a716e807e0f2eb278ff442ee2b

Security Warning

Your API keys carry the same privileges as your user account. Keep them secret and never expose them in client-side code (browsers), GitHub, or public repositories.

Rate Limits & Quotas

API usage shares the same daily file quota as your user account. Rate limits are applied per API key to prevent abuse.

Quotas (Files/Day)

  • Free Tier 15
  • Creator ($5/mo) 1,000
  • Limitless ($20/mo) Unlimited

Rate Limits

  • Anonymous 20 req/15m
  • Free Account 60 req/15m
  • Paid Account 200-600 req/15m

Transcode Media

POST/transcode

Convert media files and/or update metadata. This is a multipart/form-data request.

Parameters

FieldTypeReqDescription
fileFileYesThe media file to process (Max 500MB).
outputFormatStringNoTarget extension (e.g. mp3, mp4). Defaults to original.
ffmpegArgsJSONNoArray of FFmpeg flags (e.g. ["-b:a","192k"]).
cover_artFileNoImage file (jpg/png) to embed as cover art.

Example Request

bash
curl -X POST https://www.bulkmetadataeditor.com/api/v1/transcode \
  -H "X-API-Key: sk_live_..." \
  -F "file=@input.mp4" \
  -F "outputFormat=mp3" \
  -F 'ffmpegArgs=["-b:a","192k"]' \
  --output output.mp3

Allowed FFmpeg Flags

Standard encoding flags are permitted. Dangerous flags (protocols, filters, file access) are strictly blocked.

-map-c:v-c:a-b:v-b:a-metadata-ss-t

Probe Metadata

POST/probe

Extract technical and tag metadata from a file without counting toward your daily quota.

Example Request

bash
curl -X POST https://www.bulkmetadataeditor.com/api/v1/probe \
  -H "X-API-Key: sk_live_..." \
  -F "file=@song.mp3"

API Key Management

These endpoints are used for managing keys programmatically via the web dashboard. Authentication requires a user session (Cookie/Bearer token), not an API Key.

GET/api/keys

List all active API keys.

POST/api/keys

Generate a new API key.

DELETE/api/keys/:id

Revoke a key immediately.