使用条件 POST /api/uploads, その後、返された tus にアップロード upload_url. imagick, esrgan, video_convert, audio_convert, archive, pandocのみが必要です。
AMPX API
分かりやすいREST APIでファイル変換、ツール処理、結果の取り扱いを自動化できます。
APIアクセスは有料アドオンです
Starter、Basic、Pro を選択し、同じ月間 Stripe サブスクリプションに API キーを追加します。 API は、同じアカウントのクレジットプールとレート制限を Web ツールとして使用しています。
コンバージョンAPIワークフロー
ステップ2でURLのダウンロードが開始されます。 ファイルコンバータは、最初に保存し、tus でファイルをアップロードします。
お問い合わせ POST /api/convert サービス付き type ソース URL または割り当てられたアップロードデータのいずれか。
電話番号 GET /api/status?token=... 状態が状態になるまで finished, failed または cancelled. トークンは作成した API キーにスコープ付けされます。
返された使用 download_url または GET /d/{token}. ユニットとテキストユーティリティは同期的に戻り、ステータスポーリングをスキップします。
Starter
Basic
Pro
利用可能なサービスとクレジット価格
運用が成功したときにのみクレジットが請求されます。 失敗またはキャンセルされたジョブは予約を解除します。 ファイル操作は、最終出力の 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トークンとしてキーを送信します。 作成時や回転時にのみ表示されます。
限界および充満
鍵は、Webアカウントと同じクレジットと操作/分の制限を使用します。 成功するユーティリティは、即時に請求されます。非同期ジョブは、クレジットを予約し、完了後に解決します。
機械読みやすいドキュメント
認証済みのOpenAPI 3.1ドキュメントを同じベアラーヘッダで取得します。
サービス参照
API の操作と必要なフィールドを以下にリストします。 追加する Idempotency-Key リクエストを再試行するとき
POST /api/uploads — ファイルのアップロードを割り当てる
お問い合わせ imagick, esrgan, video_convert, audio_convert, archive, pandoc, 1 つ以上のファイル名を割り当てます。 それぞれのファイルを tus で返してアップロードする upload_url, 返されたファイルメタデータを保存します。 返されたトークンを提出するか、または files[].relative_path Pandoc の作業者、 /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"
}
}
アップロードする tus 1.0: アップロードリソースを作成する upload_url. 両方とも token そして、 filename お問い合わせ Upload-Metadata base64 エンコードされた値です。 応答は、その中のresumableリソースURLを返します Location ヘッダー。
バイトをアップロードする Location. 転送が再開した場合は、現在のオフセットをtusで取得します。 HEAD リクエストとして、その値をリクエストとして送信し、 Upload-Offset.
POST /api/convert — ビデオダウンロード
YouTube、TikTok、Reddit、Instagram、Facebook、Twitch、X、Vimeo、その他のサポートされているソースからビデオをダウンロードしてください。 基礎価格: 12クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
type | string|required |
url | string|required |
format | string|optional |
quality | string|optional |
fps | integer|optional |
playlist | boolean|optional |
source_service | string|optional |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — オーディオダウンロード
サポートされているメディア URL からオーディオを抽出します。 基礎価格: 8クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
type | string|required |
url | string|required |
format | mp3|m4a|flac|aac |
quality | string|optional |
playlist | boolean|optional |
source_service | string|optional |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — 画像コンバーターとバルクエディタ
アップロードした画像を変換、サイズ変更、クロップ、回転、編集します。 基礎価格: 5クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
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) |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — オーディオコンバーター
アップロードされたオーディオファイルを変換します。 基礎価格: 5クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — ビデオコンバーター
アップロードした動画を手帳で変換 FFmpeg プリセット YouTube, Instagram Reels または TikTok Shortsお問い合わせ 基礎価格: 12クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
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 |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — アーカイブコンバーター
アップロードされたアーカイブを作成または変換します。 基礎価格: 5クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
output_format | string|required |
max_output_bytes | integer|optional |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — 文書のコンバーター
サポートされているアップロードされたドキュメントを Pandoc で変換します。 基礎価格: 5クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
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) |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — AIイメージアップスケール
アップロードした画像をESRGANモデルでアップスケールアップ。 基礎価格: 25クレジット, 1クレジット(s)/開始10 MBの最終出力.
| フィールド | タイプ/条件 |
|---|---|
type | string|required |
token | string|required (from POST /api/uploads) |
model | string|optional |
scale | integer|optional (2-4) |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/convert — Proxyチェッカー
HTTP、HTTPS、またはSOCKSproxiesのバッチを確認してください。 基礎価格: 1クレジット.
| フィールド | タイプ/条件 |
|---|---|
type | string|required |
proxies | array|required |
default_protocol | string|optional |
timeout_sec | integer|optional |
connect_timeout_sec | integer|optional |
test_url | url|optional |
成功した投稿のリターン token, state, status_url, download_url クレジットカード決済
POST /api/utilities/unit-convert — 単位のコンバーター
同期 単位のコンバーター操作。 基礎価格: 1クレジット.
| フィールド | タイプ/条件 |
|---|---|
category | string|required |
from | string|required |
to | string|required |
value | number|required |
precision | integer|optional |
このユーティリティは、結果と請求された使用と同期的に応答します。
POST /api/utilities/text — テキストユーティリティ
同期 テキストユーティリティ操作。 基礎価格: 1クレジット.
| フィールド | タイプ/条件 |
|---|---|
text | string|required |
operations | array|optional |
このユーティリティは、結果と請求された使用と同期的に応答します。
ステータスとダウンロード例
唯一の投票 status_url あなたの仕事のために返される。 その状態が finished そして、 ready 本当です、続いて下さい download_url; 失敗し、キャンセルされたジョブは、予約されたクレジットを解放します。
{
"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_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 |