हर फ़ाइल वर्कफ़्लो के लिए एक सार्वभौमिक API

यह endpoint खुला है, इसलिए डेवलपर API key का अनुरोध करने या उसे कॉन्फ़िगर करने से पहले universal conversion catalog की जाँच कर सकते हैं।

curl "https://api.converter.app/public/pairs"

JavaScript

const response = await fetch('https://api.converter.app/public/pairs');
const pairs = await response.json();
console.log(pairs.supported_pairs);

Python

import requests

response = requests.get('https://api.converter.app/public/pairs')
response.raise_for_status()
pairs = response.json()
print(pairs['supported_pairs'])

उदाहरण प्रतिक्रिया

{
  "supported_pairs": [
    { "from": "mp3", "to": "text" },
    { "from": "mp4", "to": "mp3" },
    { "from": "mov", "to": "mp4" },
    { "from": "wav", "to": "mp3" },
    { "from": "mkv", "to": "mp4" }
  ]
}

जब आप उसी HTTP प्रतिक्रिया में तुरंत परिणाम चाहते हैं, तो सिंक्रोनस कन्वर्ज़न का उपयोग करें। अनुरोध तब तक खुला रहता है जब तक API कन्वर्ज़न जॉब शुरू करता है और उसके पूरा होने का इंतज़ार करता है, अधिकतम 30 मिनट तक।

फ़ॉर्म फ़ील्ड	प्रकार	विवरण
target_format	स्ट्रिंग	अनुरोधित आउटपुट एक्सटेंशन, जैसे pdf, docx, mp3, या jpg।
files	file[]	एक या अधिक अपलोड की गई स्रोत फ़ाइलें। API अपलोड की गई फ़ाइल के नाम से स्रोत फ़ॉर्मेट निर्धारित करती है।

curl -X POST "https://api.converter.app/convert/sync" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "target_format=pdf" \
  -F "files=@/path/to/document.docx" \
  -o converted.pdf

JavaScript

const form = new FormData();
form.append('target_format', 'pdf');
form.append('files', fileInput.files[0]);

const response = await fetch('https://api.converter.app/convert/sync', {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey
  },
  body: form
});

const convertedFile = await response.blob();

Python

import requests

headers = {'X-API-Key': 'YOUR_API_KEY'}
data = {'target_format': 'pdf'}

with open('/path/to/document.docx', 'rb') as document:
    files = {'files': document}
    response = requests.post(
        'https://api.converter.app/convert/sync',
        headers=headers,
        data=data,
        files=files
    )

response.raise_for_status()
with open('converted.pdf', 'wb') as output:
    output.write(response.content)

प्रतिक्रिया सीधे कन्वर्ट की गई फ़ाइल को स्ट्रीम करती है। यदि कन्वर्ज़न से कई फ़ाइलें बनती हैं, तो API एक .zip आर्काइव लौटाता है।

भारी फ़ाइलों, बैच प्रोसेसिंग, लंबे चलने वाले ऑडियो या वीडियो कार्यों, या ऐसे प्रोडक्शन अनुप्रयोगों के लिए असिंक्रोनस कन्वर्ज़न का उपयोग करें, जिन्हें काम चलने के दौरान अपलोड अनुरोध खुले नहीं रखने चाहिए।

फॉर्म फ़ील्ड	प्रकार	विवरण
target_format	string	वांछित आउटपुट प्रारूप। स्रोत और लक्ष्य मिलकर कन्वर्ज़न जोड़ी बनाते हैं, उदाहरण के लिए mp42mp3।
files	file[]	कन्वर्ट करने के लिए एक या अधिक फ़ाइलें।

cURL

curl -X POST "https://api.converter.app/convert" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "target_format=mp3" \
  -F "files=@/path/to/video.mp4"

JavaScript

const form = new FormData();
form.append('target_format', 'mp3');
form.append('files', fileInput.files[0]);

const response = await fetch('https://api.converter.app/convert', {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey
  },
  body: form
});

const job = await response.json();
console.log(job.jobid, job.remaining_quota);

Python

import requests

headers = {'X-API-Key': 'YOUR_API_KEY'}
data = {'target_format': 'mp3'}

with open('/path/to/video.mp4', 'rb') as video:
    files = {'files': video}
    response = requests.post(
        'https://api.converter.app/convert',
        headers=headers,
        data=data,
        files=files
    )

response.raise_for_status()
job = response.json()
print(job['jobid'], job['remaining_quota'])

सफलता प्रतिक्रिया

{
  "status": "success",
  "jobid": "b3f6b2e8f5c34c4ab01c93c4d1b2f9e8",
  "pair": "mp42mp3",
  "remaining_quota": 42
}

एक असिंक्रोनस जॉब बनाने के बाद इस endpoint को पोल करें। यह जॉब की स्थिति, 0.0 से 1.0 तक का संख्यात्मक प्रगति मान, और यदि कन्वर्ज़न विफल हो जाए तो त्रुटि विवरण लौटाता है।

हेडर	विवरण
X-API-Key	आपकी डेवलपर API कुंजी।

curl "https://api.converter.app/progress/b3f6b2e8f5c34c4ab01c93c4d1b2f9e8" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch('https://api.converter.app/progress/b3f6b2e8f5c34c4ab01c93c4d1b2f9e8', {
  headers: {
    'X-API-Key': apiKey
  }
});

const progress = await response.json();
console.log(progress.status, progress.progress);

Python

import requests

headers = {'X-API-Key': 'YOUR_API_KEY'}
response = requests.get(
    'https://api.converter.app/progress/b3f6b2e8f5c34c4ab01c93c4d1b2f9e8',
    headers=headers
)
response.raise_for_status()
progress = response.json()
print(progress['status'], progress['progress'])

{
  "jobid": "b3f6b2e8f5c34c4ab01c93c4d1b2f9e8",
  "progress": 1.0,
  "status": "completed",
  "error": null
}

संभावित स्थितियाँ processing, completed और failed हैं। प्रगति 0.0 और 1.0 के बीच की एक संख्या है।

जब कोई asynchronous job completed तक पहुँच जाए, तब job बनाने के लिए इस्तेमाल की गई उसी API key से converted output प्राप्त करें।

परिणाम प्रकार	व्यवहार
एकल आउटपुट फ़ाइल	API परिवर्तित फ़ाइल को सीधे स्ट्रीम करता है।
resultfile मेनिफेस्ट	यदि कार्य एक परिणाम मैनिफ़ेस्ट प्रदान करता है, तो API उस मैनिफ़ेस्ट में निर्दिष्ट फ़ाइल लौटाता है।
एकाधिक आउटपुट फ़ाइलें	API पैकेज फ़ाइलों को तुरंत एक .zip आर्काइव में पैक करता है।

curl -L "https://api.converter.app/download/b3f6b2e8f5c34c4ab01c93c4d1b2f9e8" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o converted-output.zip

JavaScript

const response = await fetch('https://api.converter.app/download/b3f6b2e8f5c34c4ab01c93c4d1b2f9e8', {
  headers: {
    'X-API-Key': apiKey
  }
});

const file = await response.blob();

Python

import requests

headers = {'X-API-Key': 'YOUR_API_KEY'}
response = requests.get(
    'https://api.converter.app/download/b3f6b2e8f5c34c4ab01c93c4d1b2f9e8',
    headers=headers
)
response.raise_for_status()

with open('converted-output.zip', 'wb') as output:
    output.write(response.content)