공지사항
개발자 API

AMPX API

간결한 REST API로 파일 변환, 도구 작업 및 결과 처리를 자동화하세요.

POST /api/convert

API 액세스는 유료 애드온입니다.

스타터, Basic 또는 Pro를 선택하고 같은 월간 Stripe 구독에 API 키를 추가하십시오. API는 동일한 계정 신용 풀과 속도 제한을 웹 도구로 사용합니다.

API 워크플로우 변환

URL 다운로드는 단계 2에서 시작합니다. File converters first 예비 및 업로드 파일 tus.

한 Bearer 키 · 공유 계획 제한
1
Allocate 및 업로드 파일

제품 정보 POST /api/uploads, 그런 다음 반환에 tus 업로드 upload_url. imagick, esrgan, video_convert, audio_convert, archive, pandoc에서만 필요합니다.

2
자주 묻는 질문

지원하다 POST /api/convert 서비스 type 소스 URL 또는 할당 된 업로드 데이터 중 하나.

3
오염 소유 업무 상태

이름 * GET /api/status?token=... 국가까지 finished, failed 또는 cancelled. 토큰은 생성 된 API 키에 적용된다.

4
다운로드

반환하기 download_url 또는 GET /d/{token}. Unit 및 text utilities는 비동기적으로 및 Skip 상태 오염을 반환합니다.

Starter

크레딧 / 청구 사이클10,000
비율 제한10/min
API 키별도의 유료 추가

Basic

크레딧 / 청구 사이클25,000
비율 제한30/min
API 키별도의 유료 추가

Pro

크레딧 / 청구 사이클60,000
비율 제한60/min
API 키별도의 유료 추가

사용 가능한 서비스 및 신용 가격

크레딧은 작업이 성공할 때만 청구됩니다. 실패 또는 취소 작업은 예약을 해제합니다. 파일 작업은 최종 출력의 10 MB를 시작 당 표시된 크기 충전을 추가합니다.

(주)제품정보기본 크레딧최종사이즈주요연혁
Video 다운로드
YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo 또는 다른 지원 소스에서 비디오를 다운로드하십시오.
한국어 12 +1 / 시작하기 10 MB 지원하다
Audio 다운로드
지원되는 미디어 URL에서 오디오를 추출합니다.
한국어 8 +1 / 시작하기 10 MB 지원하다
이미지 변환기 및 대량 편집기
변환, 크기, 작물, 회전 및 편집 하나 이상의 업로드 이미지.
한국어 5 +1 / 시작하기 10 MB 지원하다
오디오 변환기
업로드 된 오디오 파일을 변환합니다.
한국어 5 +1 / 시작하기 10 MB 지원하다
영상 변환기
FFmpeg 사전 설정 YouTube, Instagram Reels 또는 TikTok Shorts.
한국어 12 +1 / 시작하기 10 MB Temporarily 비활성화
아카이브 변환기
업로드 된 아카이브를 만들거나 변환합니다.
한국어 5 +1 / 시작하기 10 MB 지원하다
문서 변환기
지원된 업로드 문서를 Pandoc로 변환합니다.
한국어 5 +1 / 시작하기 10 MB Temporarily 비활성화
AI 이미지 upscaler
지원된 ESRGAN 모델로 업로드 된 이미지를 업 스케일.
한국어 25 +1 / 시작하기 10 MB 지원하다
Proxy 검사기
HTTP, HTTPS 또는 SOCKS proxies의 배치를 확인하십시오.
한국어 1 / 5 제품정보 이름 * 지원하다
단위 변환기
기타 제품 단위 변환기 가동.
뚱 베어 1 이름 * 지원하다
텍스트 유틸리티
기타 제품 텍스트 유틸리티 작업.
뚱 베어 1 이름 * 지원하다

회사연혁

Bearer 토큰으로 키를 보냅니다. 만들거나 회전하면 한 번만 표시됩니다.

Authorization: Bearer ampx_live_...

제한 및 충전

키는 웹 계정으로 동일한 신용 및 운영 / 분 제한을 사용합니다. 성공적인 유틸리티는 즉시 청구됩니다. 비동기 작업은 신용을 예약하고 완료 후 정착합니다.

기계 읽기 쉬운 docs

같은 Bearer 헤더를 가진 Authenticated OpenAPI 3.1 문서를 붙여넣으십시오.

GET https://ampx.cc/api/openapi.json

서비스 참고

모든 API 작업 및 필수 필드는 아래에 나열되어 있습니다. 기타 제품 Idempotency-Key 요청을 복원 할 때.

POST /api/uploads — 파일 할당

제품 정보 imagick, esrgan, video_convert, audio_convert, archive, pandoc, 먼저 한 개 이상의 파일 이름을 할당합니다. 반환에 tus를 가진 각 파일을 업로드 upload_url, 반환된 파일 메타데이터를 보존합니다. 반환된 토큰을 제출하거나 files[].relative_path 그리고 Pandoc에 대한 작업자, /api/convert.

curl -X POST 'https://ampx.cc/api/uploads' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"mode":"imagick","filenames":["input.png"]}'
{
  "ok": true,
  "data": {
    "token": "UPLOAD_TOKEN",
    "worker": "worker1",
    "files": [{"name": "input.png", "relative_path": "UPLOAD_TOKEN/input.png"}],
    "upload_url": "https://worker.example/api/upload/tus",
    "protocol": "tus"
  }
}

tus 1.0로 업로드: 업로드 리소스를 만듭니다. upload_url. 둘 다 token · filename 내 계정 Upload-Metadata base64 인코딩 값입니다. 응답은 resumable 리소스 URL을 반환합니다. Location 헤더.

curl -i -X POST '<UPLOAD_URL>' \ -H 'Tus-Resumable: 1.0.0' \ -H 'Upload-Length: <FILE_SIZE_BYTES>' \ -H 'Upload-Metadata: token <BASE64_UPLOAD_TOKEN>,filename <BASE64_FILENAME>'

파일 업로드 Location. 전송 이력서가 있으면, tus로 현재 오프셋을 얻을 HEAD 요청 및 그 값을 보내 Upload-Offset.

curl -X PATCH '<LOCATION_FROM_POST>' \ -H 'Tus-Resumable: 1.0.0' \ -H 'Content-Type: application/offset+octet-stream' \ -H 'Upload-Offset: 0' \ --data-binary '@input.png'
POST /api/convert — Video 다운로드

YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo 또는 다른 지원 소스에서 비디오를 다운로드하십시오. 기본 가격: 12 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
urlstring|required
formatstring|optional
qualitystring|optional
fpsinteger|optional
playlistboolean|optional
source_servicestring|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"video","url":"https://www.youtube.com/watch?v=VIDEO_ID","format":"mp4","quality":"1080p","playlist":false,"source_service":"youtube"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — Audio 다운로드

지원되는 미디어 URL에서 오디오를 추출합니다. 기본 가격: 8 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
urlstring|required
formatmp3|m4a|flac|aac
qualitystring|optional
playlistboolean|optional
source_servicestring|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"audio","url":"https://soundcloud.com/artist/track","format":"mp3","quality":"320","playlist":false,"source_service":"soundcloud"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — 이미지 변환기 및 대량 편집기

변환, 크기, 작물, 회전 및 편집 하나 이상의 업로드 이미지. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatstring|required
operationsobject|optional (auto_orient, trim, strip, quality, rotate, flip, flop, invert, resize, fit or pad)
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"imagick","token":"UPLOAD_TOKEN","output_format":"webp","operations":{"auto_orient":true,"invert":true,"resize":"1920x1080>","quality":85}}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — 오디오 변환기

업로드 된 오디오 파일을 변환합니다. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatstring|required
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"audio_convert","token":"UPLOAD_TOKEN","output_format":"mp3"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — 영상 변환기

FFmpeg 사전 설정 YouTube, Instagram Reels 또는 TikTok Shorts. 기본 가격: 12 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatmp4|webm|required
presetyoutube|instagram_reels|tiktok_shorts|square_mp4|classic_4_3|widescreen_16_9|generic_mp4|generic_webm|optional
aspect_ratiopreset|source|1:1|4:3|16:9|9:16|optional
fit_modepad|crop|stretch|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"video_convert","token":"UPLOAD_TOKEN","output_format":"mp4","preset":"youtube"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — 아카이브 변환기

업로드 된 아카이브를 만들거나 변환합니다. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
tokenstring|required (from POST /api/uploads)
output_formatstring|required
max_output_bytesinteger|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"archive","token":"UPLOAD_TOKEN","output_format":"zip"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — 문서 변환기

지원된 업로드 문서를 Pandoc로 변환합니다. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
input_pathstring|required (files[].relative_path returned by POST /api/uploads)
from_formatstring|required
to_formatstring|required
workerstring|required (from POST /api/uploads)
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"pandoc","input_path":"UPLOAD_TOKEN/document.docx","from_format":"docx","to_format":"pdf","worker":"worker1"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — AI 이미지 upscaler

지원된 ESRGAN 모델로 업로드 된 이미지를 업 스케일. 기본 가격: 25 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.

제품정보유형/요구
typestring|required
tokenstring|required (from POST /api/uploads)
modelstring|optional
scaleinteger|optional (2-4)
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"esrgan","token":"UPLOAD_TOKEN","model":"realesrgan-x4plus","scale":4}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/convert — Proxy 검사기

HTTP, HTTPS 또는 SOCKS proxies의 배치를 확인하십시오. 기본 가격: 1 크레딧.

제품정보유형/요구
typestring|required
proxiesarray|required
default_protocolstring|optional
timeout_secinteger|optional
connect_timeout_secinteger|optional
test_urlurl|optional
curl -X POST 'https://ampx.cc/api/convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"type":"proxy_check","proxies":["http://127.0.0.1:8080","socks5://127.0.0.1:1080"],"default_protocol":"http","timeout_sec":15,"connect_timeout_sec":5,"test_url":"https://example.com/"}'

성공적인 제출 반환 token, state, status_url, download_url 예약 금액.

POST /api/utilities/unit-convert — 단위 변환기

기타 제품 단위 변환기 가동. 기본 가격: 1 크레딧.

제품정보유형/요구
categorystring|required
fromstring|required
tostring|required
valuenumber|required
precisioninteger|optional
curl -X POST 'https://ampx.cc/api/utilities/unit-convert' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"category":"length","from":"m","to":"ft","value":10,"precision":4}'

이 유틸리티는 결과적으로 비동기적으로 응답하고 사용료를 청구합니다.

POST /api/utilities/text — 텍스트 유틸리티

기타 제품 텍스트 유틸리티 작업. 기본 가격: 1 크레딧.

제품정보유형/요구
textstring|required
operationsarray|optional
curl -X POST 'https://ampx.cc/api/utilities/text' \ -H 'Authorization: Bearer <AMPX_API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"text":"Convert this title","operations":["uppercase","slug"]}'

이 유틸리티는 결과적으로 비동기적으로 응답하고 사용료를 청구합니다.

상태 및 다운로드 예

설문 조사 status_url 당신의 일을 위해 반환. 그 상태는 finished · ready 진정한, 따르다 download_url; 실패 및 취소 작업은 예약 된 크레딧을 공개합니다.

curl 'https://ampx.cc/api/status?token=JOB_TOKEN' \ -H 'Authorization: Bearer <AMPX_API_KEY>'
{
  "ok": true,
  "data": {
    "token": "JOB_TOKEN",
    "state": "finished",
    "ready": true,
    "download_url": "https://ampx.cc/d/JOB_TOKEN"
  }
}

오류 계약

오류 사용 {"ok":false,"error":{"code":"…","message":"…"}}. 액세스는 효과적인 유료 플랜 플러스 별도의 API 부가 기능, 또는 API 액세스가 활성화 된 관리자 보조금이 필요합니다.

이름 *HTTP
bearer_token_missing401
invalid_api_key403
paid_plan_required403
api_addon_required403
billing_not_active403
rate_limit_exceeded429
upload_too_large413
credits_exhausted429
idempotency_conflict409
invalid_request422
scope_not_allowed403
service_disabled503
사이트 상태 체크인 ...