Überspringen zum Inhalt
Entwickler-API

AMPX API

Automatisiere Dateikonvertierungen, Tool-Aufgaben und die Ergebnisverarbeitung mit einer übersichtlichen REST API.

POST /api/convert

API Access ist ein kostenpflichtiges Add-on

Wählen Sie Starter, Basic oder Pro und fügen Sie dann den API-Schlüssel zu demselben monatlichen Stripe-Abonnement hinzu. Die API verwendet den gleichen Kontokreditpool und das gleiche Zinslimit wie die Web-Tools.

Conversion API Workflow

URL-Downloads beginnen bei Schritt 2. Dateikonverter reservieren und laden zuerst Dateien mit tus hoch.

Ein Bearer-Schlüssel · Shared Plan Limits
1
Zuweisen und Hochladen von Dateien

Verwendung POST /api/uploads, Dann laden Sie mit tus auf die zurückgegebene upload_url. Nur für imagick, esrgan, video_convert, audio_convert, archive, pandoc erforderlich.

2
Einreichung des Vorhabens

Senden POST /api/convert mit einem Dienst type und entweder eine Quell-URL oder die zugewiesenen Upload-Daten.

3
Umfrage im Besitz des Arbeitsplatzes

Anruf GET /api/status?token=... Bis der Staat finished, failed oder cancelled. Das Token ist auf den API-Schlüssel beschränkt, der es erstellt hat.

4
Download des Ergebnisses

Verwenden Sie die zurückgegebene download_url oder GET /d/{token}. Unit- und Text-Dienstprogramme kehren synchron zurück und überspringen Statusabfragen.

Starter

Credits / Abrechnungszyklus10,000
Begrenzungssatz10/min
API SchlüsselSeparates bezahltes Add-on

Basic

Credits / Abrechnungszyklus25,000
Begrenzungssatz30/min
API SchlüsselSeparates bezahltes Add-on

Pro

Credits / Abrechnungszyklus60,000
Begrenzungssatz60/min
API SchlüsselSeparates bezahltes Add-on

Verfügbare Dienstleistungen und Kreditpreise

Credits werden nur dann belastet, wenn eine Operation erfolgreich ist. Gescheiterte oder abgesagte Jobs geben ihre Reservierung frei. Dateioperationen fügen die gezeigte Ladungsgröße pro gestartetem 10 MB der endgültigen Ausgabe hinzu.

DienstTypBasiskrediteEndkundenentgeltStatus
Video Download
Laden Sie Videos von YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo oder einer anderen unterstützten Quelle herunter.
Arbeit 12 +1 / Beginn 10 MB verfügbar
Audio Download
Extrahieren Sie Audio aus einer unterstützten Medien-URL.
Arbeit 8 +1 / Beginn 10 MB verfügbar
Bildwandler und Masseneditor
Konvertieren, ändern, beschneiden, drehen und bearbeiten Sie ein oder mehrere hochgeladene Bilder.
Arbeit 5 +1 / Beginn 10 MB verfügbar
Audiowandler
Konvertieren Sie eine hochgeladene Audiodatei.
Arbeit 5 +1 / Beginn 10 MB verfügbar
Videowandler
Konvertieren Sie ein hochgeladenes Video mit einer zulässigen FFmpeg-Voreinstellung für YouTube, Instagram Reels oder TikTok Shorts.
Arbeit 12 +1 / Beginn 10 MB Zeitweilig behindert
Archivkonverter
Erstellen oder Konvertieren eines hochgeladenen Archivs.
Arbeit 5 +1 / Beginn 10 MB verfügbar
Dokumentenkonverter
Konvertieren Sie ein unterstütztes hochgeladenes Dokument mit Pandoc.
Arbeit 5 +1 / Beginn 10 MB Zeitweilig behindert
AI Image Upscaler
Skalieren Sie ein hochgeladenes Bild mit einem unterstützten ESRGAN-Modell.
Arbeit 25 +1 / Beginn 10 MB verfügbar
Proxy Checker
Überprüfen Sie eine Charge von HTTP, HTTPS oder SOCKS proxies.
Arbeit 1 / 5 Positionen Keine verfügbar
Einheitenkonverter
Synchron Einheitenumrichterbetrieb.
Versorgungsleistungen 1 Keine verfügbar
Text Dienstprogramme
Synchron Text Utilities Operation.
Versorgungsleistungen 1 Keine verfügbar

Authentifizierung

Senden Sie den Schlüssel als Bearer-Token. Es wird nur einmal angezeigt, wenn es erstellt oder gedreht wird.

Authorization: Bearer ampx_live_...

Grenzwerte und Gebühren

Der Schlüssel verwendet die gleichen Credits und Operationen / Minute Limit wie das Web-Konto. Ein erfolgreiches Versorgungsunternehmen wird sofort berechnet; ein asynchroner Job reserviert Gutschriften und begleicht sie nach Abschluss.

Maschinenlesbare Dokumente

Holen Sie das authentifizierte OpenAPI 3.1-Dokument mit dem gleichen Bearer-Header ab.

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

Betriebsnummer

Alle API-Operationen und erforderlichen Felder sind unten aufgeführt. Addition Idempotency-Key beim Wiederholen einer Anfrage.

POST /api/uploads — Datei-Uploads zuweisen

für imagick, esrgan, video_convert, audio_convert, archive, pandoc, zuerst einen oder mehrere Dateinamen zuweisen. Laden Sie jede Datei mit tus auf die zurückgegebene upload_url, Bewahrung der zurückgegebenen Metadaten. Geben Sie dann das zurückgegebene Token ein oder files[].relative_path und Arbeiter für Pandoc, an /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"
  }
}

Hochladen mit tus 1.0: Erstellen Sie die Upload-Ressource unter upload_url. Beide token und filename in Upload-Metadata sind base64-kodierte Werte. Die Antwort gibt die wiederverwendbare Ressourcen-URL in ihrem Location Header.

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

Upload von Bytes zu diesem Location. Wenn eine Übertragung fortgesetzt wird, erhalten Sie den aktuellen Offset mit einem Tus HEAD Anfordern und senden Sie diesen Wert als 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 Download

Laden Sie Videos von YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo oder einer anderen unterstützten Quelle herunter. Grundpreis: 12 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Audio Download

Extrahieren Sie Audio aus einer unterstützten Medien-URL. Grundpreis: 8 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Bildwandler und Masseneditor

Konvertieren, ändern, beschneiden, drehen und bearbeiten Sie ein oder mehrere hochgeladene Bilder. Grundpreis: 5 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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}}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Audiowandler

Konvertieren Sie eine hochgeladene Audiodatei. Grundpreis: 5 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Videowandler

Konvertieren Sie ein hochgeladenes Video mit einer zulässigen FFmpeg-Voreinstellung für YouTube, Instagram Reels oder TikTok Shorts. Grundpreis: 12 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Archivkonverter

Erstellen oder Konvertieren eines hochgeladenen Archivs. Grundpreis: 5 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Dokumentenkonverter

Konvertieren Sie ein unterstütztes hochgeladenes Dokument mit Pandoc. Grundpreis: 5 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — AI Image Upscaler

Skalieren Sie ein hochgeladenes Bild mit einem unterstützten ESRGAN-Modell. Grundpreis: 25 Kredit(e), plus 1 Credit(s) pro gestartetem 10 MB Endausgabe.

FeldTyp/Anforderung
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}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/convert — Proxy Checker

Überprüfen Sie eine Charge von HTTP, HTTPS oder SOCKS proxies. Grundpreis: 1 Kredit(e).

FeldTyp/Anforderung
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/"}'

Eine erfolgreiche Einreichung kehrt zurück token, state, status_url, download_url und den reservierten Kreditbetrag.

POST /api/utilities/unit-convert — Einheitenkonverter

Synchron Einheitenumrichterbetrieb. Grundpreis: 1 Kredit(e).

FeldTyp/Anforderung
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}'

Dieses Dienstprogramm reagiert synchron mit seinem Ergebnis und der geladenen Nutzung.

POST /api/utilities/text — Text Dienstprogramme

Synchron Text Utilities Operation. Grundpreis: 1 Kredit(e).

FeldTyp/Anforderung
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"]}'

Dieses Dienstprogramm reagiert synchron mit seinem Ergebnis und der geladenen Nutzung.

Status und Download Beispiel

Poll nur die status_url für ihren Job zurückgekehrt. Wenn sein Zustand finished und ready ist wahr, folgen download_url; gescheiterte und annullierte Jobs geben ihre reservierten Kredite frei.

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

Fehlervertrag

Fehlerverwendung {"ok":false,"error":{"code":"…","message":"…"}}. Access erfordert einen effektiven kostenpflichtigen Plan plus das separate API-Add-On oder einen Administratorzuschuss mit aktiviertem API-Zugriff.

CodeHTTP
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
Status des Gebiets Überprüfung ...