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.
API AMPX
Avtomatiziraj pretvarjanje datotek, uporabna opravila in obdelavo rezultatov s preglednim REST API-jem.
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.
Pošlji POST /api/convert s storitvijo type in bodisi izvorni URL ali dodeljeni podatki o nalaganju.
Klic GET /api/status?token=... dokler država ni finished, failed ali cancelled. Žeton je razširjen na API ključ, ki ga je ustvaril.
Uporabi vrnjeno download_url ali GET /d/{token}. Enote in besedilne službe se vrnejo sinhrono in preskočijo ankete.
Starter
Basic
Pro
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.
| Servis | Vrsta | Osnovni krediti | Naboj končne velikosti | Stanje |
|---|---|---|---|---|
| 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.
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.
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.
{
"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.
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.
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.
| Polje | Vrsta / zahteva |
|---|---|
type | string|required |
url | string|required |
format | string|optional |
quality | string|optional |
fps | integer|optional |
playlist | boolean|optional |
source_service | string|optional |
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.
| Polje | Vrsta / zahteva |
|---|---|
type | string|required |
url | string|required |
format | mp3|m4a|flac|aac |
quality | string|optional |
playlist | boolean|optional |
source_service | string|optional |
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.
| Polje | Vrsta / zahteva |
|---|---|
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) |
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.
| Polje | Vrsta / zahteva |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
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.
| Polje | Vrsta / zahteva |
|---|---|
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 |
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.
| Polje | Vrsta / zahteva |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
max_output_bytes | integer|optional |
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.
| Polje | Vrsta / zahteva |
|---|---|
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) |
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.
| Polje | Vrsta / zahteva |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
model | string|optional |
scale | integer|optional (2-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.
| Polje | Vrsta / zahteva |
|---|---|
type | string|required |
proxies | array|required |
default_protocol | string|optional |
timeout_sec | integer|optional |
connect_timeout_sec | integer|optional |
test_url | url|optional |
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.
| Polje | Vrsta / zahteva |
|---|---|
category | string|required |
from | string|required |
to | string|required |
value | number|required |
precision | integer|optional |
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.
| Polje | Vrsta / zahteva |
|---|---|
text | string|required |
operations | array|optional |
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.
{
"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.
| Oznaka | 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 |