모든 파일 작업 흐름을 위한 하나의 범용 API

이 엔드포인트는 공개되어 있어, 개발자는 API 키를 요청하거나 구성하기 전에 범용 변환 카탈로그를 확인할 수 있습니다.

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	문자열	원하는 출력 형식입니다. 소스와 대상이 변환 쌍을 이룹니다. 예: mp42mp3.
files	file[]	변환할 파일 1개 이상.

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
}

비동기 작업을 생성한 후 이 엔드포인트를 폴링하세요. 작업 상태, 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 사이의 숫자입니다.

비동기 작업이 completed 상태에 도달하면, 작업을 생성할 때 사용한 동일한 API 키로 변환된 결과를 가져오십시오.

결과 유형	행동
단일 출력 파일	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)