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.
API de AMPX
Automatiza conversiones de archivos, tareas de utilidades y resultados con una API REST clara.
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.
Enviar POST /api/convert con un servicio type y una URL de origen o los datos de carga asignados.
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ó.
Utilice el devuelto download_url o GET /d/{token}. Las utilidades de unidad y texto regresan sincronizadamente y saltan las encuestas de estado.
Starter
Basic
Pro
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.
| Servicio | Tipo | Créditos básicos | Cargo de tamaño final | Situació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.
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.
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.
{
"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.
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.
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.
| Campo | Tipo / requisito |
|---|---|
type | string|required |
url | string|required |
format | string|optional |
quality | string|optional |
fps | integer|optional |
playlist | boolean|optional |
source_service | string|optional |
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.
| Campo | Tipo / requisito |
|---|---|
type | string|required |
url | string|required |
format | mp3|m4a|flac|aac |
quality | string|optional |
playlist | boolean|optional |
source_service | string|optional |
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.
| Campo | Tipo / requisito |
|---|---|
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) |
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.
| Campo | Tipo / requisito |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
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.
| Campo | Tipo / requisito |
|---|---|
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 |
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.
| Campo | Tipo / requisito |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
max_output_bytes | integer|optional |
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.
| Campo | Tipo / requisito |
|---|---|
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) |
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.
| Campo | Tipo / requisito |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
model | string|optional |
scale | integer|optional (2-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).
| Campo | Tipo / requisito |
|---|---|
type | string|required |
proxies | array|required |
default_protocol | string|optional |
timeout_sec | integer|optional |
connect_timeout_sec | integer|optional |
test_url | url|optional |
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).
| Campo | Tipo / requisito |
|---|---|
category | string|required |
from | string|required |
to | string|required |
value | number|required |
precision | integer|optional |
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).
| Campo | Tipo / requisito |
|---|---|
text | string|required |
operations | array|optional |
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.
{
"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ódigo | 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 |