コンテンツへスキップ
開発者API

AMPX API

分かりやすいREST APIでファイル変換、ツール処理、結果の取り扱いを自動化できます。

POST /api/convert

APIアクセスは有料アドオンです

Starter、Basic、Pro を選択し、同じ月間 Stripe サブスクリプションに API キーを追加します。 API は、同じアカウントのクレジットプールとレート制限を Web ツールとして使用しています。

コンバージョンAPIワークフロー

ステップ2でURLのダウンロードが開始されます。 ファイルコンバータは、最初に保存し、tus でファイルをアップロードします。

1つのベアラーキー・共有プランの制限
1
ファイルの割り当てとアップロード

使用条件 POST /api/uploads, その後、返された tus にアップロード 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 一時的に無効
AIイメージアップスケール
アップロードした画像をESRGANモデルでアップスケールアップ。
求人情報 25 +1 / スタート 10 MB 利用できる
Proxyチェッカー
HTTP、HTTPS、またはSOCKSproxiesのバッチを確認してください。
求人情報 1 / 5 アイテム なし 利用できる
単位のコンバーター
同期 単位のコンバーター操作。
ユーティリティ 1 なし 利用できる
テキストユーティリティ
同期 テキストユーティリティ操作。
ユーティリティ 1 なし 利用できる

認証

Bearerトークンとしてキーを送信します。 作成時や回転時にのみ表示されます。

Authorization: Bearer ampx_live_...

限界および充満

鍵は、Webアカウントと同じクレジットと操作/分の制限を使用します。 成功するユーティリティは、即時に請求されます。非同期ジョブは、クレジットを予約し、完了後に解決します。

機械読みやすいドキュメント

認証済みのOpenAPI 3.1ドキュメントを同じベアラーヘッダで取得します。

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

サービス参照

API の操作と必要なフィールドを以下にリストします。 追加する Idempotency-Key リクエストを再試行するとき

POST /api/uploads — ファイルのアップロードを割り当てる

お問い合わせ imagick, esrgan, video_convert, audio_convert, archive, pandoc, 1 つ以上のファイル名を割り当てます。 それぞれのファイルを tus で返してアップロードする upload_url, 返されたファイルメタデータを保存します。 返されたトークンを提出するか、または files[].relative_path 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"
  }
}

アップロードする tus 1.0: アップロードリソースを作成する upload_url. 両方とも token そして、 filename お問い合わせ Upload-Metadata base64 エンコードされた値です。 応答は、その中のresumableリソース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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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 — AIイメージアップスケール

アップロードした画像をESRGANモデルでアップスケールアップ。 基礎価格: 25クレジット, 1クレジット(s)/開始10 MBの最終出力.

フィールドタイプ/条件
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、またはSOCKSproxiesのバッチを確認してください。 基礎価格: 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
サイトの状態 チェックイン