Saltar para o conteúdo
API para desenvolvedores

API da AMPX

Automatize conversões de arquivos, tarefas de ferramentas e resultados com uma API REST simples.

POST /api/convert

O acesso à API é um complemento pago

Escolha Starter, Basic ou Pro, em seguida, adicione a chave API para essa mesma assinatura mensal Stripe. A API usa o mesmo pool de crédito de conta e limite de taxa que as ferramentas web.

Fluxo de trabalho da API de conversão

Os downloads de URL começam no passo 2. Os conversores de arquivos primeiro reserva e upload de arquivos com tus.

Uma chave do portador · limites de plano compartilhado
1
Alocar e enviar ficheiros

Utilização POST /api/uploads, em seguida, enviar com tus para o retornado upload_url. Só é necessário para imagick, esrgan, video_convert, audio_convert, archive, pandoc.

2
Enviar a operação

Enviar POST /api/convert com um serviço type e uma URL de origem ou os dados de envio alocados.

3
Situação do posto de trabalho na pesquisa

Chamada GET /api/status?token=... até que o estado esteja finished, failed ou cancelled. O token é escopo para a chave API que o criou.

4
Baixar o resultado

Usar o retornado download_url ou GET /d/{token}. Utilitários de unidade e texto retornam síncrona e ignoram pesquisas de status.

Starter

Créditos / ciclo de faturamento10,000
Limite de taxa10/min
Chave da APISuplemento pago separado

Basic

Créditos / ciclo de faturamento25,000
Limite de taxa30/min
Chave da APISuplemento pago separado

Pro

Créditos / ciclo de faturamento60,000
Limite de taxa60/min
Chave da APISuplemento pago separado

Serviços disponíveis e preços de crédito

Os créditos só são cobrados quando uma operação é bem sucedida. Falha ou cancelamento de trabalhos liberam sua reserva. Operações de arquivo adicionam a carga de tamanho mostrada por 10 MB de saída final.

ServiçoTipoCréditos de baseCarga de tamanho finalEstado
Transferência de vídeo
Baixar vídeo de YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo ou outra fonte suportada.
trabalho 12 +1 / iniciado 10 MB Disponível
Transferência de áudio
Extrair áudio de uma URL de mídia suportada.
trabalho 8 +1 / iniciado 10 MB Disponível
Conversor de imagens e editor de volume
Converter, redimensionar, cortar, girar e editar uma ou mais imagens enviadas.
trabalho 5 +1 / iniciado 10 MB Disponível
conversor de áudio
Converter um arquivo de áudio carregado.
trabalho 5 +1 / iniciado 10 MB Disponível
Conversor de vídeo
Converter um vídeo carregado com uma lista autorizada FFmpeg predefinido para YouTube, Instagram Reels ou TikTok Shorts.
trabalho 12 +1 / iniciado 10 MB Desactivado temporariamente
Conversor de arquivos
Criar ou converter um arquivo carregado.
trabalho 5 +1 / iniciado 10 MB Disponível
Conversor de documentos
Converta um documento carregado com o Pandoc.
trabalho 5 +1 / iniciado 10 MB Desactivado temporariamente
Escalador de imagem de IA
Aumentar uma imagem enviada com um modelo ESRGAN suportado.
trabalho 25 +1 / iniciado 10 MB Disponível
Verificador Proxy
Verifique um lote de HTTP, HTTPS ou SOCKS proxies.
trabalho 1 / 5 itens Nenhum Disponível
Conversor unitário
Sincronizado Operação de conversor de unidade.
utilitário 1 Nenhum Disponível
Utilitários de texto
Sincronizado Operação de utilitários de texto.
utilitário 1 Nenhum Disponível

autenticação

Envie a chave como um símbolo de portador. É mostrado apenas uma vez quando criado ou rodado.

Authorization: Bearer ampx_live_...

Limites e tarifação

A chave utiliza os mesmos créditos e operações/limite de minutos que a conta web. Um utilitário bem sucedido é cobrado imediatamente; um crédito de reserva de trabalho assíncrono e os liquida após a conclusão.

Documentos legíveis por máquina

Obter o documento OpenAPI 3.1 autenticado com o mesmo cabeçalho do portador.

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

Referência do serviço

Todas as operações da API e campos obrigatórios estão listados abaixo. Adicionar Idempotency-Key ao tentar novamente um pedido.

POST /api/uploads — alocar uploads de arquivos

Para imagick, esrgan, video_convert, audio_convert, archive, pandoc, primeiro alocar um ou mais nomes de arquivos. Enviar cada arquivo com o tus para o retornado upload_url, preservando os metadados de arquivo retornados. Em seguida, enviar o token devolvido, ou files[].relative_path e trabalhador para o Pandoc, /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"
  }
}

Enviar com tus 1.0: criar o recurso de envio em upload_url. Ambos token e filename em Upload-Metadata são valores codificados por base64. A resposta devolve o URL do recurso reutilizável na sua Location Cabeçalho.

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

Enviar bytes para isso Location. Se uma transferência retomar, obtenha o deslocamento atual com um tus HEAD solicitar e enviar esse 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 — Transferência de vídeo

Baixar vídeo de YouTube, TikTok, Reddit, Instagram, Facebook, Twitch, X, Vimeo ou outra fonte suportada. Preço base: Crédito(s) 12, mais 1 crédito(s) por 10 iniciado MB de saída 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"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Transferência de áudio

Extrair áudio de uma URL de mídia suportada. Preço base: Crédito(s) 8, mais 1 crédito(s) por 10 iniciado MB de saída 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"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Conversor de imagens e editor de volume

Converter, redimensionar, cortar, girar e editar uma ou mais imagens enviadas. Preço base: Crédito(s) 5, mais 1 crédito(s) por 10 iniciado MB de saída 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}}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — conversor de áudio

Converter um arquivo de áudio carregado. Preço base: Crédito(s) 5, mais 1 crédito(s) por 10 iniciado MB de saída 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"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Conversor de vídeo

Converter um vídeo carregado com uma lista autorizada FFmpeg predefinido para YouTube, Instagram Reels ou TikTok Shorts. Preço base: Crédito(s) 12, mais 1 crédito(s) por 10 iniciado MB de saída 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"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Conversor de arquivos

Criar ou converter um arquivo carregado. Preço base: Crédito(s) 5, mais 1 crédito(s) por 10 iniciado MB de saída 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"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Conversor de documentos

Converta um documento carregado com o Pandoc. Preço base: Crédito(s) 5, mais 1 crédito(s) por 10 iniciado MB de saída 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"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Escalador de imagem de IA

Aumentar uma imagem enviada com um modelo ESRGAN suportado. Preço base: Crédito(s) 25, mais 1 crédito(s) por 10 iniciado MB de saída 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}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/convert — Verificador Proxy

Verifique um lote de HTTP, HTTPS ou SOCKS proxies. Preço base: Crédito(s) 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/"}'

Uma apresentação bem- sucedida retorna token, state, status_url, download_url e o montante de crédito reservado.

POST /api/utilities/unit-convert — Conversor unitário

Sincronizado Operação de conversor de unidade. Preço base: Crédito(s) 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}'

Este utilitário responde síncrono com seu resultado e uso cobrado.

POST /api/utilities/text — Utilitários de texto

Sincronizado Operação de utilitários de texto. Preço base: Crédito(s) 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"]}'

Este utilitário responde síncrono com seu resultado e uso cobrado.

Status e exemplo de download

Apenas o status_url Voltou para o seu emprego. Quando o seu estado é finished e ready é verdade, siga download_url; falhas e cancelamento de trabalhos liberam seus 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 erro

Erros de uso {"ok":false,"error":{"code":"…","message":"…"}}. O acesso requer um plano pago efetivo e o complemento de API separado, ou uma concessão de administrador com acesso de 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
Status do site A verificar...