Passer au contenu
API développeur

API AMPX

Automatisez les conversions de fichiers, les outils et le traitement des résultats avec une API REST claire.

POST /api/convert

L'accès à l'API est un complément payant

Choisissez Starter, Basic ou Pro, puis ajoutez la touche API à ce même abonnement mensuel Stripe. L'API utilise le même compte de crédit et limite de taux que les outils Web.

Processus d'API de conversion

Les téléchargements d'URL commencent à l'étape 2. Convertisseurs de fichiers d'abord réserver et télécharger des fichiers avec tus.

Une clé au porteur · limites du régime partagé
1
Attribuer et télécharger des fichiers

Utilisation POST /api/uploads, puis télécharger avec tus vers le retour upload_url. Requis uniquement pour imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
Soumettre l'opération

Envoyer POST /api/convert avec un service type et soit une URL source ou les données de téléchargement attribuées.

3
Statut d ' emploi appartenant au scrutin

Appeler GET /api/status?token=... jusqu'à ce que l'État soit finished, failed ou cancelled. Le jeton est étendu à la clé API qui l'a créé.

4
Télécharger le résultat

Utiliser le retour download_url ou GET /d/{token}. Utilitaires d'unité et de texte retournent synchrone et sautent le vote d'état.

Starter

Crédits / cycle de facturation10,000
Taux limite10/min
Clé APIAdditif séparé payé

Basic

Crédits / cycle de facturation25,000
Taux limite30/min
Clé APIAdditif séparé payé

Pro

Crédits / cycle de facturation60,000
Taux limite60/min
Clé APIAdditif séparé payé

Services disponibles et prix du crédit

Les crédits ne sont facturés que lorsqu'une opération réussit. La réservation a été annulée ou annulée. Opérations de fichier ajouter la charge de taille affichée par démarré 10 MB de sortie finale.

ServicesTypeCrédits de baseCharge de taille finaleÉtat
Téléchargement vidéo
Télécharger la vidéo de YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo ou une autre source prise en charge.
emploi 12 +1 / commencé 10 MB Disponible
Téléchargement audio
Extraire l'audio d'une URL multimédia prise en charge.
emploi 8 +1 / commencé 10 MB Disponible
Convertisseur d'image et éditeur en vrac
Convertir, redimensionner, recadrer, tourner et modifier une ou plusieurs images téléchargées.
emploi 5 +1 / commencé 10 MB Disponible
Convertisseur audio
Convertir un fichier audio téléchargé.
emploi 5 +1 / commencé 10 MB Disponible
Convertisseur vidéo
Convertir une vidéo téléchargée avec un préréglage FFmpeg autorisé pour YouTube, Instagram Reels ou TikTok Shorts.
emploi 12 +1 / commencé 10 MB Handicapés temporaires
Convertisseur d'archives
Créer ou convertir une archive téléchargée.
emploi 5 +1 / commencé 10 MB Disponible
Convertisseur de documents
Convertir un document téléchargé avec Pandoc.
emploi 5 +1 / commencé 10 MB Handicapés temporaires
IA image upscaler
Mettre à niveau une image téléchargée avec un modèle ESRGAN pris en charge.
emploi 25 +1 / commencé 10 MB Disponible
Vérificateur Proxy
Vérifiez un lot de HTTP, HTTPS ou SOCKS proxies.
emploi 1 / 5 Éléments Aucune Disponible
Convertisseur d'unité
synchrone Fonctionnement du convertisseur d'unité.
utilité 1 Aucune Disponible
Utilitaires texte
synchrone Fonctionnement des utilitaires texte.
utilité 1 Aucune Disponible

Authentification

Envoyez la clé comme jeton porteur. Elle n'est montrée qu'une fois lorsqu'elle est créée ou tournée.

Authorization: Bearer ampx_live_...

Limites et charge

La clé utilise la même limite de crédits et de fonctionnement/minute que le compte Web. Une utilitaire réussie est facturée immédiatement; un emploi asynchrone se réserve des crédits et les règle après l'achèvement.

Docs lisibles par machine

Obtenez le document authentifié OpenAPI 3.1 avec le même en-tête porteur.

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

Référence du service

Toutes les opérations de l'API et les champs requis sont énumérés ci-dessous. Ajouter Idempotency-Key lors d'une nouvelle demande.

POST /api/uploads — attribuer les téléchargements de fichiers

Pour imagick, esrgan, video_convert, audio_convert, archive, pandoc, attribuer d'abord un ou plusieurs noms de fichiers. Télécharger chaque fichier avec tus dans le retour upload_url, préserver les métadonnées de fichier retournées. Puis soumettre le jeton retourné, ou files[].relative_path pour Pandoc, pour /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"
  }
}

Télécharger avec tus 1.0: créer la ressource de téléchargement à upload_url. Les deux token et filename dans Upload-Metadata sont des valeurs codées de base64. La réponse renvoie l'URL de la ressource récupérable dans son Location en-tête.

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

Envoie les octets à ça Location. Si un transfert reprend, obtenir le décalage actuel avec un tus HEAD demander et envoyer cette valeur comme 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 — Téléchargement vidéo

Télécharger la vidéo de YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo ou une autre source prise en charge. Prix de base: Crédit(s) 12, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Téléchargement audio

Extraire l'audio d'une URL multimédia prise en charge. Prix de base: Crédit(s) 8, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Convertisseur d'image et éditeur en vrac

Convertir, redimensionner, recadrer, tourner et modifier une ou plusieurs images téléchargées. Prix de base: Crédit(s) 5, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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}}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Convertisseur audio

Convertir un fichier audio téléchargé. Prix de base: Crédit(s) 5, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Convertisseur vidéo

Convertir une vidéo téléchargée avec un préréglage FFmpeg autorisé pour YouTube, Instagram Reels ou TikTok Shorts. Prix de base: Crédit(s) 12, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Convertisseur d'archives

Créer ou convertir une archive téléchargée. Prix de base: Crédit(s) 5, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Convertisseur de documents

Convertir un document téléchargé avec Pandoc. Prix de base: Crédit(s) 5, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — IA image upscaler

Mettre à niveau une image téléchargée avec un modèle ESRGAN pris en charge. Prix de base: Crédit(s) 25, Plus 1 crédit(s) par crédit 10 MB de sortie finale.

ChampType/exigence
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}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/convert — Vérificateur Proxy

Vérifiez un lot de HTTP, HTTPS ou SOCKS proxies. Prix de base: Crédit(s) 1.

ChampType/exigence
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/"}'

Retours reçus token, state, status_url, download_url et le crédit réservé.

POST /api/utilities/unit-convert — Convertisseur d'unité

synchrone Fonctionnement du convertisseur d'unité. Prix de base: Crédit(s) 1.

ChampType/exigence
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}'

Cet utilitaire répond synchronement à son résultat et à son utilisation chargée.

POST /api/utilities/text — Utilitaires texte

synchrone Fonctionnement des utilitaires texte. Prix de base: Crédit(s) 1.

ChampType/exigence
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"]}'

Cet utilitaire répond synchronement à son résultat et à son utilisation chargée.

Exemple de statut et de téléchargement

Sondage seulement status_url est revenu pour votre travail. Quand son état est finished et ready est vrai, suivez download_url; les emplois échoués et annulés libèrent leurs crédits réservés.

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

Contrat d'erreur

Erreurs d'utilisation {"ok":false,"error":{"code":"…","message":"…"}}. L'accès nécessite un régime payant effectif plus l'ajout d'API séparé, ou une subvention d'administrateur avec accès d'API activé.

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
État du site Vérification...