Skip to content
API para desarrolladores

API de AMPX

Automatiza conversiones de archivos, tareas de utilidades y resultados con una API REST clara.

POST /api/convert

El acceso a la API es un complemento pagado

Elija Starter, Basic o Pro, a continuación, añadir la clave de API a la misma suscripción mensual Stripe. La API utiliza la misma cuenta de crédito y límite de tarifas que las herramientas web.

Conversión API flujo de trabajo

Las descargas de URL comienzan a paso 2. Conversores de archivos primera reserva y subir archivos con tus.

Una clave del portador · límites del plan compartido
1
Asignar y subir archivos

Uso POST /api/uploads, entonces subir con tus tus a los devueltos upload_url. Se requiere sólo para imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
Presentar la operación

Enviar POST /api/convert con un servicio type y una URL de origen o los datos de carga asignados.

3
Situación de los empleos de propiedad de la encuesta

Call GET /api/status?token=... hasta que el estado sea finished, failed o cancelled. El token tiene alcance en la clave de API que lo creó.

4
Descargar el resultado

Utilice el devuelto download_url o GET /d/{token}. Las utilidades de unidad y texto regresan sincronizadamente y saltan las encuestas de estado.

Starter

Créditos / ciclo de facturación10,000
Tasa límite10/min
Clave de APISeparación de la suma pagada

Basic

Créditos / ciclo de facturación25,000
Tasa límite30/min
Clave de APISeparación de la suma pagada

Pro

Créditos / ciclo de facturación60,000
Tasa límite60/min
Clave de APISeparación de la suma pagada

Servicios disponibles y precios de crédito

Los créditos se cobran sólo cuando una operación tiene éxito. Trabajos fallidos o cancelados liberan su reserva. Las operaciones de archivo añaden la carga de tamaño mostrada por 10 MB de salida final.

ServicioTipoCréditos básicosCargo de tamaño finalSituación
Descarga de vídeo
Descargar video de YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo u otra fuente compatible.
trabajo 12 +1 / comenzado 10 MB Disponible
Descarga de audio
Extraiga el audio de una URL de medios compatibles.
trabajo 8 +1 / comenzado 10 MB Disponible
Conversor de imagen y editor de vracs
Convertir, redimensionar, recortar, rotar y editar una o más imágenes subidas.
trabajo 5 +1 / comenzado 10 MB Disponible
Audio convertidor
Convertir un archivo de audio subido.
trabajo 5 +1 / comenzado 10 MB Disponible
Video convertidor
Convertir un vídeo subido con un preset FFmpeg para YouTube, Instagram Reels o TikTok Shorts.
trabajo 12 +1 / comenzado 10 MB Discapacitados temporalmente
Archivo convertidor
Crear o convertir un archivo cargado.
trabajo 5 +1 / comenzado 10 MB Disponible
Documento convertidor
Convertir un documento subido compatible con Pandoc.
trabajo 5 +1 / comenzado 10 MB Discapacitados temporalmente
Ampliación de imagen de AI
Sube una imagen subida con un modelo ESRGAN compatible.
trabajo 25 +1 / comenzado 10 MB Disponible
Proxy
Revise un lote de HTTP, HTTPS o SOCKS proxies.
trabajo 1 / 5 Temas Ninguno Disponible
Unidad convertidor
Sincrónico Operación de convertidor de unidad.
utilidad 1 Ninguno Disponible
Servicios de texto
Sincrónico Operación de utilidades de texto.
utilidad 1 Ninguno Disponible

Autenticación

Envíe la llave como un token Bearer. Se muestra sólo una vez cuando se crea o gira.

Authorization: Bearer ampx_live_...

Límites y carga

La clave utiliza los mismos créditos y operaciones/minuto límite que la cuenta web. Una utilidad exitosa se cobra inmediatamente; un crédito asincrónico de reservas de empleo y los liquida después de su terminación.

Docs legibles a máquina

Obtenga el documento OpenAPI 3.1 autenticado con el mismo encabezado Bearer.

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

Referencia del servicio

Todas las operaciones de API y los campos requeridos se enumeran a continuación. Añadir Idempotency-Key cuando vuelva a iniciar una solicitud.

POST /api/uploads — asignar cargas de archivos

Para imagick, esrgan, video_convert, audio_convert, archive, pandoc, primero asignar uno o más nombres de archivo. Subir cada archivo con tus a los devueltos upload_url, preservando los metadatos de archivos devueltos. Entonces envíe la ficha devuelta, o files[].relative_path y trabajador de 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"
  }
}

Subir con tus 1.0: crear el recurso de carga en upload_url. Ambos token y filename dentro Upload-Metadata son valores cifrados en base64. La respuesta devuelve la URL del recurso resumible en su Location Cabeza.

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

Sube bytes a eso Location. Si se reanudará la transferencia, obtenga la compensación actual con un tus tus HEAD solicitar y enviar ese valor como 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 — Descarga de vídeo

Descargar video de YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo u otra fuente compatible. Precio base: 12 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Descarga de audio

Extraiga el audio de una URL de medios compatibles. Precio base: 8 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Conversor de imagen y editor de vracs

Convertir, redimensionar, recortar, rotar y editar una o más imágenes subidas. Precio base: 5 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Audio convertidor

Convertir un archivo de audio subido. Precio base: 5 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Video convertidor

Convertir un vídeo subido con un preset FFmpeg para YouTube, Instagram Reels o TikTok Shorts. Precio base: 12 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Archivo convertidor

Crear o convertir un archivo cargado. Precio base: 5 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Documento convertidor

Convertir un documento subido compatible con Pandoc. Precio base: 5 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Ampliación de imagen de AI

Sube una imagen subida con un modelo ESRGAN compatible. Precio base: 25 credit(s), más 1 credit(s) por iniciado 10 MB de salida final.

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/convert — Proxy

Revise un lote de HTTP, HTTPS o SOCKS proxies. Precio base: 1 credit(s).

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

A successful submission returns token, state, status_url, download_url y la cantidad de crédito reservada.

POST /api/utilities/unit-convert — Unidad convertidor

Sincrónico Operación de convertidor de unidad. Precio base: 1 credit(s).

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

Esta utilidad responde sincronizadamente con su resultado y su uso cargado.

POST /api/utilities/text — Servicios de texto

Sincrónico Operación de utilidades de texto. Precio base: 1 credit(s).

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

Esta utilidad responde sincronizadamente con su resultado y su uso cargado.

Ejemplo de estado y descarga

Sólo la encuesta status_url Regresó por tu trabajo. Cuando su estado es finished y ready es verdad, seguir download_url; empleos fallidos y cancelados liberan sus créditos reservados.

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

Contrato de error

Uso de errores {"ok":false,"error":{"code":"…","message":"…"}}. El acceso requiere un plan pagado eficaz más el complemento de API independiente, o una subvención de administrador con acceso a API habilitado.

CódigoHTTP
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
Situación del sitio Comprobando...