Пропустить контент
API для разработчиков

AMPX API

Автоматизируйте конвертацию файлов, задачи инструментов и обработку результатов через удобный REST API.

POST /api/convert

API-доступ — платное дополнение

Выберите Starter, Basic или Pro, а затем добавьте API-ключ к той же ежемесячной подписке Stripe. API использует тот же кредитный пул и лимит ставок, что и веб-инструменты.

Конверсия API Workflow

Загрузка URL начинается на этапе 2. Преобразователи файлов сначала резервируют и загружают файлы с помощью tus.

One Bearer Key – лимиты общего плана
1
Выделять и загружать файлы

Использовать POST /api/uploads, Затем загрузите с тюками в возвращенный upload_url. Требуется только для imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
Предоставьте операцию

Отправить POST /api/convert с услугой type либо исходный URL, либо выделенные данные загрузки.

3
Собственный статус работы

Звони. GET /api/status?token=... Пока государство не finished, failed или cancelled. Токен привязан к ключу API, который его создал.

4
Скачать результат

Используйте возвращенный download_url или GET /d/{token}. Единичные и текстовые утилиты возвращаются синхронно и пропускают опрос статуса.

Starter

Кредиты/биллинговый цикл10,000
Ограничение по ставкам10/min
Ключ APIОтдельное платное дополнение

Basic

Кредиты/биллинговый цикл25,000
Ограничение по ставкам30/min
Ключ APIОтдельное платное дополнение

Pro

Кредиты/биллинговый цикл60,000
Ограничение по ставкам60/min
Ключ APIОтдельное платное дополнение

Доступные услуги и кредитные цены

Кредиты взимаются только тогда, когда операция успешна. Неудачные или отмененные работы освобождают их резервацию. Файловые операции добавляют показанный размер заряда на запущенный 10 MB конечного вывода.

СервисТипБазовые кредитыЗаряд окончательного размерастатус
Видео скачать
Загрузите видео из YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo или другого поддерживаемого источника.
работа 12 +1 / начинать 10 MB Доступный
Скачать аудио
Извлеките аудио из поддерживаемого медиа URL.
работа 8 +1 / начинать 10 MB Доступный
Преобразователь изображений и объемный редактор
Преобразовать, изменить размер, обрезать, вращать и редактировать одно или несколько загруженных изображений.
работа 5 +1 / начинать 10 MB Доступный
Аудио конвертер
Преобразуйте загруженный аудиофайл.
работа 5 +1 / начинать 10 MB Доступный
Конвертер видео
Преобразуйте загруженное видео с помощью предустановленного списка FFmpeg для YouTube, Instagram Reels или TikTok Shorts.
работа 12 +1 / начинать 10 MB временно отключенный
Архивный конвертер
Создание или преобразование загруженного архива.
работа 5 +1 / начинать 10 MB Доступный
Преобразователь документов
Преобразуйте поддерживаемый загруженный документ в Pandoc.
работа 5 +1 / начинать 10 MB временно отключенный
ИИ Image Upscaler
Увеличьте загруженное изображение с помощью поддерживаемой модели ESRGAN.
работа 25 +1 / начинать 10 MB Доступный
Проверка Proxy
Проверьте пакет HTTP, HTTPS или SOCKS proxies.
работа 1 / 5 предметы Никто Доступный
Единичный преобразователь
синхронный Работа конвертера.
полезность 1 Никто Доступный
Текстовые коммуникации
синхронный Работа текстовых утилит.
полезность 1 Никто Доступный

аутентификация

Отправьте ключ в качестве маркера Bearer. Он проявляется только один раз при создании или повороте.

Authorization: Bearer ampx_live_...

Пределы и зарядка

Ключ использует те же кредиты и операции / минутный лимит, что и веб-счет. Успешная утилита взимается немедленно; асинхронная работа резервирует кредиты и погашает их после завершения.

Машиночитаемые документы

Получите аутентифицированный документ OpenAPI 3.1 с тем же заголовком Bearer.

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

Справка о службе

Все операции API и необходимые поля перечислены ниже. Добавить Idempotency-Key При повторном запросе.

POST /api/uploads — Распределить загрузку файлов

Для imagick, esrgan, video_convert, audio_convert, archive, pandoc, Сначала выделите одно или несколько имен файлов. Загрузите каждый файл с tus в возвращенный upload_url, сохранение возвращенных метаданных файла. Возвращается обратно или files[].relative_path Работник Пандока, для /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"
  }
}

Скачать Tus 1.0: Создайте ресурс загрузки в upload_url. Оба token и filename в Upload-Metadata Базовые 64-кодированные значения. Ответ возвращает URL-адрес возобновляемого ресурса Location Голова.

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

Загрузите байты в это Location. Если передача возобновляется, получите текущее смещение с помощью tus. HEAD Запросить и отправить это значение как 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 — Видео скачать

Загрузите видео из YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo или другого поддерживаемого источника. Базовая цена: 12 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Скачать аудио

Извлеките аудио из поддерживаемого медиа URL. Базовая цена: 8 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Преобразователь изображений и объемный редактор

Преобразовать, изменить размер, обрезать, вращать и редактировать одно или несколько загруженных изображений. Базовая цена: 5 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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}}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Аудио конвертер

Преобразуйте загруженный аудиофайл. Базовая цена: 5 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Конвертер видео

Преобразуйте загруженное видео с помощью предустановленного списка FFmpeg для YouTube, Instagram Reels или TikTok Shorts. Базовая цена: 12 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Архивный конвертер

Создание или преобразование загруженного архива. Базовая цена: 5 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Преобразователь документов

Преобразуйте поддерживаемый загруженный документ в Pandoc. Базовая цена: 5 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — ИИ Image Upscaler

Увеличьте загруженное изображение с помощью поддерживаемой модели ESRGAN. Базовая цена: 25 Кредит(ы), плюс кредит (кредиты) 1 на стартовый 10 МБ конечного продукта.

полеТип/требование
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}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/convert — Проверка Proxy

Проверьте пакет HTTP, HTTPS или SOCKS proxies. Базовая цена: 1 Кредит(ы).

полеТип/требование
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/"}'

Успешное представление возвращается token, state, status_url, download_url и резервную сумму кредита.

POST /api/utilities/unit-convert — Единичный преобразователь

синхронный Работа конвертера. Базовая цена: 1 Кредит(ы).

полеТип/требование
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}'

Эта утилита синхронно реагирует на свой результат и заряженное использование.

POST /api/utilities/text — Текстовые коммуникации

синхронный Работа текстовых утилит. Базовая цена: 1 Кредит(ы).

полеТип/требование
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"]}'

Эта утилита синхронно реагирует на свой результат и заряженное использование.

Статус и пример загрузки

Опросить только status_url Возвращался на работу. Когда его состояние finished и ready Это правда, следуйте download_url; Неудачные и отмененные рабочие места освобождают свои зарезервированные кредиты.

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

Договор об ошибках

Ошибки используют {"ok":false,"error":{"code":"…","message":"…"}}. Доступ требует эффективного платного плана плюс отдельное дополнение API или грант администратора с включенным доступом API.

КодHTTP
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
Статус сайта Проверить...