제품 정보 POST /api/uploads, 그런 다음 반환에 tus 업로드 upload_url. imagick, esrgan, video_convert, audio_convert, archive, pandoc에서만 필요합니다.
AMPX API
간결한 REST API로 파일 변환, 도구 작업 및 결과 처리를 자동화하세요.
API 액세스는 유료 애드온입니다.
스타터, Basic 또는 Pro를 선택하고 같은 월간 Stripe 구독에 API 키를 추가하십시오. API는 동일한 계정 신용 풀과 속도 제한을 웹 도구로 사용합니다.
API 워크플로우 변환
URL 다운로드는 단계 2에서 시작합니다. File converters first 예비 및 업로드 파일 tus.
지원하다 POST /api/convert 서비스 type 소스 URL 또는 할당 된 업로드 데이터 중 하나.
이름 * GET /api/status?token=... 국가까지 finished, failed 또는 cancelled. 토큰은 생성 된 API 키에 적용된다.
반환하기 download_url 또는 GET /d/{token}. Unit 및 text utilities는 비동기적으로 및 Skip 상태 오염을 반환합니다.
Starter
Basic
Pro
사용 가능한 서비스 및 신용 가격
크레딧은 작업이 성공할 때만 청구됩니다. 실패 또는 취소 작업은 예약을 해제합니다. 파일 작업은 최종 출력의 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 토큰으로 키를 보냅니다. 만들거나 회전하면 한 번만 표시됩니다.
제한 및 충전
키는 웹 계정으로 동일한 신용 및 운영 / 분 제한을 사용합니다. 성공적인 유틸리티는 즉시 청구됩니다. 비동기 작업은 신용을 예약하고 완료 후 정착합니다.
기계 읽기 쉬운 docs
같은 Bearer 헤더를 가진 Authenticated OpenAPI 3.1 문서를 붙여넣으십시오.
서비스 참고
모든 API 작업 및 필수 필드는 아래에 나열되어 있습니다. 기타 제품 Idempotency-Key 요청을 복원 할 때.
POST /api/uploads — 파일 할당
제품 정보 imagick, esrgan, video_convert, audio_convert, archive, pandoc, 먼저 한 개 이상의 파일 이름을 할당합니다. 반환에 tus를 가진 각 파일을 업로드 upload_url, 반환된 파일 메타데이터를 보존합니다. 반환된 토큰을 제출하거나 files[].relative_path 그리고 Pandoc에 대한 작업자, /api/convert.
{
"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 헤더.
파일 업로드 Location. 전송 이력서가 있으면, tus로 현재 오프셋을 얻을 HEAD 요청 및 그 값을 보내 Upload-Offset.
POST /api/convert — Video 다운로드
YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo 또는 다른 지원 소스에서 비디오를 다운로드하십시오. 기본 가격: 12 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
url | string|required |
format | string|optional |
quality | string|optional |
fps | integer|optional |
playlist | boolean|optional |
source_service | string|optional |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — Audio 다운로드
지원되는 미디어 URL에서 오디오를 추출합니다. 기본 가격: 8 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
url | string|required |
format | mp3|m4a|flac|aac |
quality | string|optional |
playlist | boolean|optional |
source_service | string|optional |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — 이미지 변환기 및 대량 편집기
변환, 크기, 작물, 회전 및 편집 하나 이상의 업로드 이미지. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
operations | object|optional (auto_orient, trim, strip, quality, rotate, flip, flop, invert, resize, fit or pad) |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — 오디오 변환기
업로드 된 오디오 파일을 변환합니다. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — 영상 변환기
FFmpeg 사전 설정 YouTube, Instagram Reels 또는 TikTok Shorts. 기본 가격: 12 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | mp4|webm|required |
preset | youtube|instagram_reels|tiktok_shorts|square_mp4|classic_4_3|widescreen_16_9|generic_mp4|generic_webm|optional |
aspect_ratio | preset|source|1:1|4:3|16:9|9:16|optional |
fit_mode | pad|crop|stretch|optional |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — 아카이브 변환기
업로드 된 아카이브를 만들거나 변환합니다. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
max_output_bytes | integer|optional |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — 문서 변환기
지원된 업로드 문서를 Pandoc로 변환합니다. 기본 가격: 5 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
input_path | string|required (files[].relative_path returned by POST /api/uploads) |
from_format | string|required |
to_format | string|required |
worker | string|required (from POST /api/uploads) |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — AI 이미지 upscaler
지원된 ESRGAN 모델로 업로드 된 이미지를 업 스케일. 기본 가격: 25 크레딧, 플러스 1 신용 (s) 시작 당 10 MB 최종 출력.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
model | string|optional |
scale | integer|optional (2-4) |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/convert — Proxy 검사기
HTTP, HTTPS 또는 SOCKS proxies의 배치를 확인하십시오. 기본 가격: 1 크레딧.
| 제품정보 | 유형/요구 |
|---|---|
type | string|required |
proxies | array|required |
default_protocol | string|optional |
timeout_sec | integer|optional |
connect_timeout_sec | integer|optional |
test_url | url|optional |
성공적인 제출 반환 token, state, status_url, download_url 예약 금액.
POST /api/utilities/unit-convert — 단위 변환기
기타 제품 단위 변환기 가동. 기본 가격: 1 크레딧.
| 제품정보 | 유형/요구 |
|---|---|
category | string|required |
from | string|required |
to | string|required |
value | number|required |
precision | integer|optional |
이 유틸리티는 결과적으로 비동기적으로 응답하고 사용료를 청구합니다.
POST /api/utilities/text — 텍스트 유틸리티
기타 제품 텍스트 유틸리티 작업. 기본 가격: 1 크레딧.
| 제품정보 | 유형/요구 |
|---|---|
text | string|required |
operations | array|optional |
이 유틸리티는 결과적으로 비동기적으로 응답하고 사용료를 청구합니다.
상태 및 다운로드 예
설문 조사 status_url 당신의 일을 위해 반환. 그 상태는 finished · ready 진정한, 따르다 download_url; 실패 및 취소 작업은 예약 된 크레딧을 공개합니다.
{
"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_missing | 401 |
invalid_api_key | 403 |
paid_plan_required | 403 |
api_addon_required | 403 |
billing_not_active | 403 |
rate_limit_exceeded | 429 |
upload_too_large | 413 |
credits_exhausted | 429 |
idempotency_conflict | 409 |
invalid_request | 422 |
scope_not_allowed | 403 |
service_disabled | 503 |