Submit Media Conversion Job

POST

/api/conversion

Submit a new media conversion job via REST API.

Security: Commands are built securely from structured parameters to prevent injection attacks.

Two input modes:

Single Input - Use input field for one file

Multiple Inputs - Use inputs array for complex workflows (slideshows, multi-file processing)

Parameters: All FFmpeg options go in the parameters object as key-value pairs.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Job submitted successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/conversion' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": "/tmp/input.mov",
    "output": "/tmp/output.mp4",
    "format": "mp4",
    "parameters": {
        "c:v": "libx264",
        "crf": "23",
        "preset": "medium",
        "c:a": "aac",
        "b:a": "192k"
    }
}'

Response Example

202 - Example 1

{
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "PENDING",
    "message": "Job queued for processing"
}

Modified at 2025-11-17 21:28:22

Refresh Access Token

Query Job Status