documentation
documentation_info
High-volume API pair reliability
Recent anonymous API rollups by supported source and target format, including request volume, success rate, error rate, and average conversion runtime.
| Pair | Requests | Success | Errors | Avg runtime | Window |
|---|---|---|---|---|---|
| MP4 -> MP3 | 920 | 100% | 0% | 1612m 35s | 13d |
| MP4 -> MP4 | 649 | 88.8% | 11.2% | 2476m 50s | 13d |
| HEIC -> JPG | 407 | 77.4% | 22.6% | 1558m 26s | 8d |
| AVI -> MP4 | 325 | 92.9% | 7.1% | 139m 18s | 11d |
Optional client label header
For anonymous API requests, send X-Convertr-Client-Label with a stable non-PII label such as your app, workspace, or environment name. Convertr normalizes and hashes up to 80 characters before storing telemetry, keeps only the hash bucket in retained conversion rows and anonymous API rollups, and never stores the raw header value.
curl -X POST https://convertr.org/api/convert \
-H "X-Convertr-Client-Label: acme-mobile-production" \
-F "[email protected]" \
-F "input_format=mp4" \
-F "output_format=mp3"Register an API client
Create a token from the same stable client label you use for anonymous requests. Anonymous conversions stay available with the same 1 GB upload limit.
curl -X POST https://convertr.org/api/client-registrations \
-H "X-Convertr-Client-Label: acme-mobile-production" \
-H "Accept: application/json" \
-d "name=Acme Mobile" \
-d "[email protected]" \
-d "password=secret-password" \
-d "password_confirmation=secret-password"Registration response support fields
The registration response includes the hashed anonymous_api_client_cohort for your label. Include that value and the affected pair, such as HEIC -> JPG, when contacting support so we can inspect the matching rollups and failures.
{
"message": "API client registered. Use the returned bearer token with /api/convert.",
"user": {
"anonymous_api_client_cohort": "cohort_0123abcd4567ef89"
},
"token": {
"type": "Bearer",
"plain_text_token": "1|..."
},
"anonymous_access": {
"available": true,
"upload_limit": "1 GB"
}
}one_api_plan
Easy pricing means no surprises.
- free_image_conversions
- support_email_twitter
- video_processing_tasks
- audio_processing_tasks
- image_processing_tasks
customized_plan_info
what_conversion_minute
what_conversion_minute_info
which_payment_methods
which_payment_methods_info
out_of_balance
out_of_balance_info
full_minute
full_minute_info