Preskoči na vsebino
API za razvijalce

API AMPX

Avtomatiziraj pretvarjanje datotek, uporabna opravila in obdelavo rezultatov s preglednim REST API-jem.

POST /api/convert

API dostop je plačan dodatek

Izberite paket Starter, Basic ali Pro in isti mesečni naročnini Stripe dodajte dostop do API-ja. API uporablja isto dobroimetje in omejitev števila zahtevkov kot spletna orodja.

Delovni tok API za pretvorbo

URL prenosi se začnejo na koraku 2. Pretvorniki datotek prvo rezervo in naložite datoteke s tus.

En ključ medveda · omejitve skupnega načrta
1
Dodeli in naloži datoteke

Uporaba POST /api/uploads, nato naloži s tos na vrnjeno upload_url. Zahteva se samo za imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
Predloži operacijo

Pošlji POST /api/convert s storitvijo type in bodisi izvorni URL ali dodeljeni podatki o nalaganju.

3
Status zaposlitve v lasti podjetja

Klic GET /api/status?token=... dokler država ni finished, failed ali cancelled. Žeton je razširjen na API ključ, ki ga je ustvaril.

4
Prenesi rezultat

Uporabi vrnjeno download_url ali GET /d/{token}. Enote in besedilne službe se vrnejo sinhrono in preskočijo ankete.

Starter

Krediti/obračunski cikel10,000
Omejitev stopnje10/min
Ključ APILočen plačani pribitek

Basic

Krediti/obračunski cikel25,000
Omejitev stopnje30/min
Ključ APILočen plačani pribitek

Pro

Krediti/obračunski cikel60,000
Omejitev stopnje60/min
Ključ APILočen plačani pribitek

Razpoložljive storitve in cene kreditov

Krediti se obračunajo samo ob uspešnem opravilu. Pri neuspešnih ali preklicanih opravilih se rezervirani krediti sprostijo. Pri opravilih z datotekami se prikazani strošek glede velikosti prišteje za vsakih začetih 10 MB končne datoteke.

ServisVrstaOsnovni kreditiNaboj končne velikostiStanje
Prenos videa
Prenesi video iz YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo ali drug podprt vir.
delo 12 +1 / začeto 10 MB Na voljo
Zvočni prenos
Izvlecite zvok iz podprtega večpredstavnostnega URL- ja.
delo 8 +1 / začeto 10 MB Na voljo
Pretvornik slik in urejevalnik razsutega tovora
Pretvarjanje, spreminjanje velikosti, pridelek, vrtenje in urejanje eno ali več prenesenih slik.
delo 5 +1 / začeto 10 MB Na voljo
Pretvornik zvoka
Pretvori naloženo zvočno datoteko.
delo 5 +1 / začeto 10 MB Na voljo
Video pretvornik
Pretvorite naložen video s prednastavljenim FFmpeg za YouTube, Instagram Reels ali TikTok Shorts.
delo 12 +1 / začeto 10 MB Začasno onemogočeno
Arhivski pretvornik
Ustvarite ali pretvorite naložen arhiv.
delo 5 +1 / začeto 10 MB Na voljo
Pretvornik dokumentov
Pretvori podprt naložen dokument s Pandoc.
delo 5 +1 / začeto 10 MB Začasno onemogočeno
AI, upscaler slike
Pomanjšaj naloženo sliko s podprtim modelom ESRGAN.
delo 25 +1 / začeto 10 MB Na voljo
Preverjanje Proxy
Preverite serijo HTTP, HTTPS ali SOCKS proxies.
delo 1 / 5 postavke Brez Na voljo
Pretvornik enot
Sinhrono Transverter enote.
uporabnost 1 Brez Na voljo
Pripomočki za besedila
Sinhrono Poslovanje s pomočjo besedil.
uporabnost 1 Brez Na voljo

Overovitev

Pošlji ključ kot znak za medveda. Prikazan je samo enkrat ob ustvaritvi ali vrtenju.

Authorization: Bearer ampx_live_...

Omejitve in polnjenje

Ključ uporablja isto dobroimetje in omejitev števila opravil na minuto kot spletni račun. Uspešno opravilo pripomočka se obračuna takoj; asinhrono opravilo najprej rezervira kredite in jih dokončno obračuna po zaključku.

Strojno berljivi izdelki

Pridobite overovljeni dokument OpenAPI 3.1 z isto glavo medveda.

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

Sklic na storitev

Vse operacije API in zahtevana polja so navedena spodaj. Dodaj Idempotency-Key ob ponovnem poskusu prošnje.

POST /api/uploads — Dodeli datoteke

Za imagick, esrgan, video_convert, audio_convert, archive, pandoc, najprej dodeli eno ali več imen datotek. Naloži vsako datoteko s tus na vrnjeno upload_url, ohranjanje vrnjenih metapodatkov o datoteki. Nato predloži nazaj žeton, ali files[].relative_path in delavec za 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"
  }
}

Naloži s tus 1.0: ustvari vir za pošiljanje na upload_url. obe token ter filename v Upload-Metadata so osnovne vrednosti64 kodirane. Odziv vrne URL vira, ki ga je mogoče oddati v svojem Location Glava.

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>'

Naloži bajte na to Location. Če se prenos nadaljuje, pridobite trenutni odmik s tokom HEAD zahtevajte in pošljite to vrednost kot 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 — Prenos videa

Prenesi video iz YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo ali drug podprt vir. Osnovna cena: Krediti 12, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Zvočni prenos

Izvlecite zvok iz podprtega večpredstavnostnega URL- ja. Osnovna cena: Krediti 8, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Pretvornik slik in urejevalnik razsutega tovora

Pretvarjanje, spreminjanje velikosti, pridelek, vrtenje in urejanje eno ali več prenesenih slik. Osnovna cena: Krediti 5, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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}}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Pretvornik zvoka

Pretvori naloženo zvočno datoteko. Osnovna cena: Krediti 5, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Video pretvornik

Pretvorite naložen video s prednastavljenim FFmpeg za YouTube, Instagram Reels ali TikTok Shorts. Osnovna cena: Krediti 12, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Arhivski pretvornik

Ustvarite ali pretvorite naložen arhiv. Osnovna cena: Krediti 5, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Pretvornik dokumentov

Pretvori podprt naložen dokument s Pandoc. Osnovna cena: Krediti 5, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — AI, upscaler slike

Pomanjšaj naloženo sliko s podprtim modelom ESRGAN. Osnovna cena: Krediti 25, plus 1 krediti na začetek 10 MB končnega izhoda.

PoljeVrsta / zahteva
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}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/convert — Preverjanje Proxy

Preverite serijo HTTP, HTTPS ali SOCKS proxies. Osnovna cena: Krediti 1.

PoljeVrsta / zahteva
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/"}'

Uspešna predložitev vrne token, state, status_url, download_url in rezerviranega zneska kredita.

POST /api/utilities/unit-convert — Pretvornik enot

Sinhrono Transverter enote. Osnovna cena: Krediti 1.

PoljeVrsta / zahteva
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}'

Ta pripomoček se odziva sinhrono s svojim rezultatom in napolnjeno uporabo.

POST /api/utilities/text — Pripomočki za besedila

Sinhrono Poslovanje s pomočjo besedil. Osnovna cena: Krediti 1.

PoljeVrsta / zahteva
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"]}'

Ta pripomoček se odziva sinhrono s svojim rezultatom in napolnjeno uporabo.

Primer stanja in prejemanja

Poll samo status_url Vrnili so se zaradi službe. Ko je njeno stanje finished ter ready je res, sledite download_url; neuspešna in preklicana delovna mesta sprostijo svoje rezervirane kredite.

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"
  }
}

Pogodba o napaki

Uporaba napak {"ok":false,"error":{"code":"…","message":"…"}}. Dostop zahteva učinkovit plačan načrt in ločen API dodatek ali administratorsko štipendijo z omogočenim dostopom API.

OznakaHTTP
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
Stanje območja Preverjanje...