Salta al contenuto
API per sviluppatori

API AMPX

Automatizza conversioni di file, attività degli strumenti e gestione dei risultati con una chiara API REST.

POST /api/convert

L'accesso API è un add-on a pagamento

Scegliere Starter, Basic o Pro, quindi aggiungere la chiave API a quello stesso abbonamento mensile Stripe. L'API utilizza lo stesso pool di credito e il limite di tasso degli strumenti web.

Conversione flusso di lavoro API

I download dell'URL iniziano al passo 2. I convertitori di file prima riservano e caricano i file con tus.

Una chiave del cuscinetto · limiti di piano condivisi
1
Allocare e caricare i file

Uso POST /api/uploads, poi caricare con tus al ritorno upload_url. Richiesto solo per imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
Inviare l'operazione

Invia POST /api/convert con un servizio type e sia un URL sorgente o i dati di caricamento assegnati.

3
Poll Stato di lavoro di proprietà

Chiamata GET /api/status?token=... fino a quando lo stato è finished, failed o cancelled. Il token è indirizzato alla chiave API che lo ha creato.

4
Scarica il risultato

Utilizzare il restituito download_url o GET /d/{token}. Unità e utilità di testo ritornano sincronizzati e saltano lo stato polling.

Starter

Crediti / ciclo di fatturazione10,000
Limite di tasso10/min
Chiave APISupplemento a pagamento separato

Basic

Crediti / ciclo di fatturazione25,000
Limite di tasso30/min
Chiave APISupplemento a pagamento separato

Pro

Crediti / ciclo di fatturazione60,000
Limite di tasso60/min
Chiave APISupplemento a pagamento separato

Servizi disponibili e prezzi di credito

I crediti sono addebitati solo quando un'operazione riesce. I lavori non registrati o annullati rilasciano la loro prenotazione. Le operazioni di file aggiungono la carica di dimensione mostrata per 10 MB di uscita finale.

ServizioTipoCrediti baseCarica a grandezza finaleStato
Scarica il video
Scaricare video da YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo o un'altra fonte supportata.
lavoro 12 +1 / iniziato 10 MB Disponibile
Scarica audio
Estrarre l'audio da un URL supportato.
lavoro 8 +1 / iniziato 10 MB Disponibile
Convertitore di immagini e editor di massa
Convertire, ridimensionare, ritagliare, ruotare e modificare una o più immagini caricate.
lavoro 5 +1 / iniziato 10 MB Disponibile
Convertitore audio
Convertire un file audio caricato.
lavoro 5 +1 / iniziato 10 MB Disponibile
Convertitore di video
Converti un video caricato con una preimpostazione FFmpeg per YouTube, Instagram Reels o TikTok Shorts.
lavoro 12 +1 / iniziato 10 MB Disabilitazione temporanea
Convertitore di archivio
Creare o convertire un archivio caricato.
lavoro 5 +1 / iniziato 10 MB Disponibile
Convertitore di documenti
Convertire un documento caricato supportato con Pandoc.
lavoro 5 +1 / iniziato 10 MB Disabilitazione temporanea
AI immagine upscaler
Scalare un'immagine caricata con un modello ESRGAN supportato.
lavoro 25 +1 / iniziato 10 MB Disponibile
Checker Proxy
Controllare un lotto di HTTP, HTTPS o SOCKS proxies.
lavoro 1 / 5 Articolo Nessuno Disponibile
Convertitore di unità
Traduzione: Operazione del convertitore di unità.
utilità 1 Nessuno Disponibile
Utilità del testo
Traduzione: Funzionamento di utilità di testo.
utilità 1 Nessuno Disponibile

Autenticazione

Invia la chiave come un token Bearer. Viene mostrato solo una volta creato o ruotato.

Authorization: Bearer ampx_live_...

Limiti e ricarica

La chiave utilizza gli stessi crediti e operazioni/minuto del conto web. Un'utilità di successo viene addebitata immediatamente; un lavoro asincrono riserva crediti e li regola dopo il completamento.

Documenti leggibili in macchina

Prestare il documento autenticato OpenAPI 3.1 con lo stesso intestazione Bearer.

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

Riferimento del servizio

Tutte le operazioni API e i campi richiesti sono elencati di seguito. Aggiungi Idempotency-Key quando riprovare una richiesta.

POST /api/uploads — assegnare i file

Per imagick, esrgan, video_convert, audio_convert, archive, pandoc, prima assegnare uno o più nomi di file. Caricare ogni file con tus al reso upload_url, preservare i metadati di file restituiti. Quindi inviare il token restituito, o files[].relative_path e lavoratore per Pandoc, a /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"
  }
}

Carica con tus 1.0: creare la risorsa di upload upload_url. Entrambi token e filename in Upload-Metadata sono valori base64 codificati. La risposta restituisce l'URL delle risorse recuperabili nel suo Location Intestazione.

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

Caricare byte a questo Location. Se un trasferimento riprende, ottenere l'offset corrente con un tus HEAD richiedere e inviare tale valore come 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 — Scarica il video

Scaricare video da YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo o un'altra fonte supportata. Prezzo base: Credito (i) 12, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Scarica audio

Estrarre l'audio da un URL supportato. Prezzo base: Credito (i) 8, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Convertitore di immagini e editor di massa

Convertire, ridimensionare, ritagliare, ruotare e modificare una o più immagini caricate. Prezzo base: Credito (i) 5, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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}}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Convertitore audio

Convertire un file audio caricato. Prezzo base: Credito (i) 5, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Convertitore di video

Converti un video caricato con una preimpostazione FFmpeg per YouTube, Instagram Reels o TikTok Shorts. Prezzo base: Credito (i) 12, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Convertitore di archivio

Creare o convertire un archivio caricato. Prezzo base: Credito (i) 5, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Convertitore di documenti

Convertire un documento caricato supportato con Pandoc. Prezzo base: Credito (i) 5, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — AI immagine upscaler

Scalare un'immagine caricata con un modello ESRGAN supportato. Prezzo base: Credito (i) 25, plus 1 credit(s) per 10 MB di uscita finale.

CampoTipo / requisito
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}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/convert — Checker Proxy

Controllare un lotto di HTTP, HTTPS o SOCKS proxies. Prezzo base: Credito (i) 1.

CampoTipo / requisito
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/"}'

Una presentazione di successo ritorna token, state, status_url, download_url e l'importo di credito riservato.

POST /api/utilities/unit-convert — Convertitore di unità

Traduzione: Operazione del convertitore di unità. Prezzo base: Credito (i) 1.

CampoTipo / requisito
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}'

Questa utility risponde in modo sincrono con il suo risultato e l'utilizzo caricato.

POST /api/utilities/text — Utilità del testo

Traduzione: Funzionamento di utilità di testo. Prezzo base: Credito (i) 1.

CampoTipo / requisito
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"]}'

Questa utility risponde in modo sincrono con il suo risultato e l'utilizzo caricato.

Esempio di stato e download

Poll solo il status_url ritornato per il tuo lavoro. Quando il suo stato è finished e ready è vero, segui download_url; lavori falliti e annullati rilasciano i loro crediti riservati.

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

Contratto di errore

Uso degli errori {"ok":false,"error":{"code":"…","message":"…"}}. L'accesso richiede un piano pagato efficace più il componente aggiuntivo API separato, o una sovvenzione amministratore con accesso API abilitato.

CodiceHTTP
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
Stato del sito Controllo...