Transloadit
料金
  • ファイルアップロード
  • ファイルインポート
  • バッチ処理
  • 動画エンコーディング
  • 音声エンコーディング
  • 画像処理
  • ドキュメント処理
  • 人工知能
  • ファイルフィルタリングとセキュリティ
  • メディアカタログ化
  • ファイル圧縮
  • コード評価
  • ファイルエクスポート
  • Smart CDN
  • すべてのサービスを表示
  • 連携機能を見る
  • 実行可能なデモを試す (English)
  • Uppy
  • TransloaditKit
  • Android 用 SDK
  • Node.js 用 SDK
  • Next.js 用ビューアー
  • Python 用 SDK
  • Ruby 用 SDK
  • Go 用 SDK
  • Java 用 SDK
  • PHP 用 SDK
  • Zapier
  • MCP サーバー
  • Transloadit CLI
  • Terraform
  • 基本事項
  • ベストプラクティス
  • よくある質問
  • Robot
  • API
  • 形式
  • 初めてのアプリ開発
  • 会社概要
  • 比較
  • オープンソース
  • お客様の声
  • 採用情報 (English)
  • セキュリティ
  • 記事
  • 開発者ニュース (English)
  • 開発のヒント
  • プレス
  • 研究 (English)
  • 導入事例
  • ソリューション
  • ガイド (English)
  • 用語集
  • 法務 (English)
  • ツール
  • 世界中の数百万人に教育を届ける Coursera を支援
  • Transloadit サポート
  • オープンソースサポート
  • サービスレベル契約 (English)
  • エンジニアによるデモを予約 (English)
基本事項Robotよくある質問API形式ベストプラクティス
トピック
  • エンドポイント
  • レスポンスコード
  • 認証
  • ウェブフック
  • メタデータ
  • API のセキュリティ
  • レート制限
  • キュー
  • 再開可能なアップロード
認証
  • Bearer トークンを作成する
  • 新しい Auth Key を作成する
  • Auth Keys の一覧を取得する
  • Auth Key のスコープを取得する
  • Auth Key を編集する
  • Auth Key を削除する
  • Auth Key のシークレットを取得する
Assemblies
  • 新しい Assembly を作成する
  • Assembly Status を取得する
  • 指定された ID で Assembly を作成する
  • Assembly の変更をリアルタイムでストリーミングする
  • 実行中の Assembly をキャンセルする
  • Assembly を再実行する
  • Assemblies の一覧を取得する
  • Assembly Status レスポンス
  • Assembly の統計情報を取得する
ウェブフック
  • Assembly Notifications を取得する
  • Assembly Notification を再送する
請求
  • 対象月の請求書を取得する
キュー
  • 現在使用中の Priority Job Slots を取得する
  • Priority Job Slots の統計を取得する
再開可能なアップロード
  • tus の機能を確認する
  • tus アップロードを作成する
  • tus アップロードのオフセットを取得する
  • tus ファイルのバイト列をアップロードする
  • tus アップロードを終了する
  • tus アップロードをダウンロードする
Template 認証情報
  • 新しい Template 認証情報を作成する
  • Template 認証情報を取得する
  • Template 認証情報を編集する
  • Template 認証情報を削除する
  • Template 認証情報の一覧を取得する
  • Template 認証情報の種類を取得する
Templates
  • 新しい Template を作成する
  • Template を取得する
  • Template を編集する
  • Template を削除する
  • Templates の一覧を取得する
  • Cron Template の実行履歴を取得する alpha
デジタルアセット管理
  • DAM アセットを移動するか、名前を変更する alpha
  • DAM アセットを削除 alpha
  • DAM アセットを一括移動する alpha
  • DAM アセットを一括削除する alpha
  • ストレージ内のファイルまたはフォルダーを移動 alpha
  • ストレージ内のアセットを取得
  • ストレージ内のアセットを一覧表示

新しい Assembly を作成する

アップロードされたファイルと Assembly Instructions から Assembly を作成します。

POSThttps://api2.transloadit.com/assemblies

一般的なワークフロー:

  1. ファイルと処理用の Instructions を指定して、以下のリクエスト例を送信します。最終ステータスを Webhook で受け取るには、リクエストを送信する前に、その Instructions に notify_url を含めてください。
  2. 返された assembly_ssl_url は秘密にしてください。この URL を使用して進行状況を確認するか、設定済みの Webhook を待ちます。
  3. 処理済みファイルを使用する前に、ok: "ASSEMBLY_COMPLETED" になるまで待ちます。error またはキャンセルは、処理の成功を意味しません。出力ファイルは results 内で Step 名ごとにグループ化されます。レスポンスフィールドを参照してください。

直接、または Template を通じて /transloadit/import を使用する Assemblies には、Bearer トークン、または未来の時刻を示す params.auth.expires タイムスタンプを含む署名済みの params が必要です。これは、Workspace の Signature Authentication が無効になっている場合にも適用されます。Auth Key だけでは不十分です。Bearer トークンで認証されたリクエストには、別途 Signature や有効期限は必要ありません。公開ストレージ用の Builtin Templates は例外です。すべてのストレージからのインポートが、宣言された公開プレフィックスの範囲内に収まる場合に限り、署名なしのリクエストに対応できます。これは、任意の Steps を含む署名なしの Assemblies や、非公開のストレージパスへのアクセスを許可するものではありません。

Assembly は、ファイルの処理とエクスポートを行えます。Assembly Instructions は、ファイルをどのように処理するかを決定します。Instructions は直接(steps パラメータ内で)渡すことも、Template に保存することもできます(template_id パラメータで参照します)。Templates を使用すると、Instructions を再利用したり、アプリをデプロイせずに更新したり、アプリのデプロイ先にシークレットを一切公開せずに済むようにしたりできます。

このサービスへの通常の <form> アップロード(および XHR / SDK の使用)に対応するため、multipart/form-data の POST リクエストを受け付けています。

UTF-8 でエンコードされた params フィールドの上限は 1048576 バイトです。リクエストのメタデータに含められるネストされたオブジェクトまたは配列は、最大 64 個です。JSON および URL エンコードされたフォームのボディの上限は、URL エンコードによる増加分を含めて 1048576 バイトです。ファイルのアップロードにはマルチパートリクエストを使用してください。

このリクエストには、複数のファイルを含めることができます。再開可能なファイルアップロードを行う場合は、再開可能なアップロードで説明しているとおり、このリクエストにファイルを含めません。

補足

Transloadit は最大 200 GB のファイルサイズに対応しています。アプリケーションで、これより高い上限が必要な場合は、お問い合わせください。

リクエスト例

curl を使用できるサーバー側のシェルで、適切な Bearer トークンを TRANSLOADIT_TOKEN に設定して、このリクエストを実行してください。トークンが必要な場合は、以下の設定手順を展開してください。

リクエストを実行する前に、入力ファイルを ./example.jpg に配置してください。

Bearer トークンが必要ですか?

curl と jq を使用できる信頼できるサーバー側のシェルで、TRANSLOADIT_KEY と TRANSLOADIT_SECRET に、それぞれ Auth Key と Auth Secret を設定してください。両方の認証情報と生成されたトークンは秘密にしてください。この設定手順をブラウザーのコードで実行しないでください。

最初に、このエンドポイントで必要なスコープを持つトークンを作成します。Auth Key には、これらのスコープがすでに付与されている必要があります。

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=assemblies:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

このシェルを開いたまま、以下のリクエストを実行してください。トークンが有効な間は再利用してください。

curl --fail-with-body -sS --request POST \
  --url "https://api2.transloadit.com/assemblies" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --form-string 'params={"steps":{"resize":{"robot":"/image/resize","use":":original","width":320}}}' \
  --form 'file=@./example.jpg'

この後の流れ

成功の HTTP レスポンスは、Assembly が受け付けられたことを示します。処理が完了したことを意味するものではありません。最初のレスポンスは、次のようになります(抜粋。ID と URL は異なります)。

{
  "ok": "ASSEMBLY_EXECUTING",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "results": {}
}

レスポンスから assembly_ssl_url をコピーし、数秒おきにステータスを確認するか、作成前に設定した Webhook を使用してください。この URL は秘密にしてください。error またはキャンセルが発生したら停止してください。どちらも処理の成功を意味しません。

ok が ASSEMBLY_COMPLETED になると、この例の出力は results.resize に格納されています。完了時のレスポンスには、次のフィールドが含まれます(抜粋。出力 URL は説明用の例です)。

{
  "ok": "ASSEMBLY_COMPLETED",
  "message": "The Assembly was successfully completed.",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "results": {
    "resize": [
      {
        "name": "example.jpg",
        "mime": "image/jpeg",
        "ssl_url": "https://example.com/temporary-output/example.jpg",
        "meta": {
          "width": 320
        }
      }
    ]
  }
}

results.resize[0].ssl_url を使用して、リサイズされた画像をダウンロードしてください。これらの一時的な出力 URL には有効期限があります。ファイルを保持する必要がある場合は、エクスポート用の Step(/s3/store など)を追加してください。

認証

このエンドポイントは、署名付きの params または Bearer トークンを受け付けます。設定手順については、認証を参照してください。

Auth Key または Bearer トークンに必要なスコープ: assemblies:write。

キー認証を使用するリクエストでは、Signature Authentication が有効な場合に Signature が必要です。Bearer トークンでは、別途 Signature は必要ありません。

任意のレスポンスクエリパラメーター

  • callback (JavaScript コールバック名)。JSON レスポンスを JSONP コールバックでラップします。コールバック名は ^(?:_jqjsp[0-9]*|jQuery[0-9]+_[0-9]+)$ に一致する必要があります。最後に指定されたものだけが使用され、空の値は無視されます。コールバック名が無効な場合は HTTP 403 が返されます。変換後のレスポンスは HTTP 200 を使用します。コールバックはレスポンスのシリアライズ後に適用されます。

マルチパートフォームのフィールド

コンテンツタイプ: multipart/form-data

  • params (JSON 文字列)、必須。JSON エンコードされたオブジェクトで、サポートされるキーは以下のとおりです。

  • signature (文字列)。リクエストで Signature Authentication を使用する場合に必須です。

  • num_expected_upload_files (フォームフィールド)。再開可能なアップロードを使用する場合、アップロードされるファイルの数を指定します。詳細は再開可能なアップロード に記載されています。

  • tus_num_expected_upload_files (フォームフィールド)。古い SDK との互換性のために維持されている、num_expected_upload_files の旧来のエイリアスです。

  • * (バイナリまたは文字列)。バイナリファイルおよび追加の Assembly フィールドには、任意のフィールド名を使用できます。

params フィールド内でサポートされるキー

この一覧の認証フィールドは、署名付きリクエストに適用されます。Bearer トークンを使用する場合は、params.auth と、それとは別の signature フィールドを省略できます。以下の認証方式ごとのリクエストパラメーターを比較してください。

完全な JSON スキーマ

JSON を新しいタブで開く

直接指定した Steps または Template から Assembly を作成する際に使用する署名付きパラメーター。

フィールド型と説明
params.auth

署名付きリクエストでは必須。Bearer トークンを使用する場合は任意

object

署名付き Assembly リクエストの認証メタデータとアップロード制約。API キーは必須です。

少なくとも、key プロパティにお使いの Transloadit Auth Key が含まれます。

Signature Authentication を有効にする場合は、expires プロパティにリクエストの有効期限も設定する必要があります。

{
  "key": "23c96d084c744219a2ce156772ec3211",
  "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP"
}

リクエストごとに、ランダムに生成した params.nonce の値を params の最上位に含めることを強く推奨します。これにより、個別に生成された Signatures が互いに異なるものになり、Signature の意図しない再利用を防げます。nonce は再試行を冪等にするものではありません。Assembly 作成リクエストを再試行すると、別の Assembly が作成される可能性があります。必要に応じて、アプリケーション側で再試行の重複排除を処理してください。署名済みの params を異なるエンドポイント間で再利用しないでください。Template の読み取り、Auth Key の一覧取得、Template 認証情報の一覧取得、請求情報の読み取りでは、別のエンドポイントに対してすでに記録された Signatures、または Assembly の作成に使用された Signatures を、SIGNATURE_REUSE_DETECTED で拒否します。リクエストごとに新しい署名済み params を生成してください。

{
  "auth": {
    "key": "23c96d084c744219a2ce156772ec3211",
    "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP"
  },
  "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1"
}

referer プロパティは、このアップロードの HTTP referer と照合する正規表現です。たとえば、"example\.org" のように指定します。指定された Referer の値が、想定するドメインと一致するかを確認するために使用してください。

referer がないアップロードは常にチェックを通過します(一部のブラウザーでは referer が無効になっているため)。そのため、これが役立つユースケースはごく限られています。正規表現の詳細については、Mozilla の RegExp ドキュメント⁠を参照してください。

無効な正規表現と、評価時間の上限を超える正規表現は拒否されます。このチェックは Signature Authentication の代わりにはなりません。クライアントは Referer ヘッダーを省略したり、偽装したりできます。

auth.max_size プロパティは、個々のファイルではなく、Assembly 全体の想定アップロードサイズをバイト単位で制限します。たとえば、1048576(1 MiB)のように指定します。このサイズには、マルチパートリクエストのボディ、または最初の Assembly リクエストのバイト数とそれに伴う再開可能なアップロードが含まれます。上限を超えると、個別には上限内に収まるファイルも含め、Assembly 全体がエラーで停止します。

保存済みの Template、または Assembly リクエストの auth オブジェクトで上限を設定してください。Signature ベースのブラウザーアップロードでは、バックエンドでユーザーを認証し、許可された上限と Template の選択内容を含む、承認済みの Instructions のみに署名し、Signature Authentication を必須にしてください。Auth Secret と Assembly 作成用の Bearer トークンは、信頼できるバックエンドに保持してください。有効な Bearer 認証では、Signature の要件が適用されません。保存済みの Template の上限は、リクエストの上限とは独立してチェックされます。アップロードしたユーザーの検証に従ってください。

この上限によって、サイズが上限を超える転送がすべて開始前に拒否されることを前提にしないでください。再開可能なアップロードでは、申告されたサイズまたは受信済みのサイズが tus の更新を通じて利用可能になり、完了したアップロードが処理されるときに Assembly が上限をチェックします。サイズの確定を延期したアップロードのサイズは作成時には不明であり、Assembly が拒否する前に、すでにデータが転送されている場合があります。

一定のサイズを超えるファイルだけを無視し、それ以外のファイルをすべて処理したい場合は、🤖/file/filter を使用してください。

max_number_of_files プロパティを使用すると、1 回のアップロードに含められるファイル数の上限を設定できます。たとえば、100 のように指定します。ファイルアップロードとインポート Robots の両方で、ユーザーが過剰な数のファイルをアップロードするのを防ぐために、このプロパティを指定してください。

これらのプロパティは、Assembly リクエストの一部として、または Template の一部として設定できます。

params.auth: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

params.auth.expires
string

将来の日時を示す ISO 8601 形式の有効期限タイムスタンプ。リクエストが署名されている場合、または Signature Authentication が必要な場合は必須です。Bearer 認証を使用するリクエストでは省略できます。

params.auth.key

必須

string

リクエストの認証に使用する Transloadit API キー

params.auth.max_number_of_files
integer (最小値: 1)

Assembly ごとに許可される入力ファイルの最大数です。アップロードまたはインポートされたファイルの数がこの上限を超えると、Assembly はエラーで停止します。これは、Signature Authentication の認証情報が露出した場合の不正利用を防ぐのに役立ちます。

params.auth.max_size
number

リクエストボディのオーバーヘッドを含む、Assembly で想定されるアップロードの合計サイズの上限(バイト単位)。これはファイルごとの制限ではなく、再開可能な転送が始まる前に拒否されることを保証するものではありません。

params.auth.referer
string

指定された HTTP Referer と照合する正規表現です。無効な式や、評価の制限時間を超える式は拒否されます。Referer ヘッダーがない場合は、このチェックを通過します。リクエストを認証するには Signature Authentication を使用してください。

params.emit_execution_progress
boolean

リアルタイムの Assembly Execution Progress イベントを発行するには、true に設定します。URL 変換の Assemblies では、この設定は無視されます。

params.exiftool_stack
string

この Assembly でメタデータ抽出に使用する ExifTool スタックを選択します。Robot Steps の処理スタックを選択するものではありません。

params.ffmpeg_stack
string

この Assembly でメタデータ抽出に使用する FFmpeg スタックを選択します。これは Robot Steps の処理スタックを選択するものではありません。処理スタックを選択するには、該当する Robot Step で ffmpeg_stack を設定してください。

params.fields
object

文字列をキーとする値のオブジェクト(名前 -> 値)で、追加のフォームフィールドと同様に Assembly Variables として使用できます。値には、JSON として文字列化できるものであれば何でも使用できます。

追加プロパティのスキーマ
任意の値
params.imagemagick_stack
string

この Assembly でメタデータ抽出に使用する ImageMagick スタックを選択します。これは Robot Steps の処理スタックを選択するものではありません。処理スタックを選択するには、該当する Robot Step の imagemagick_stack を設定してください。

params.mediainfo_stack
string

この Assembly でメタデータ抽出に使用する MediaInfo スタックを選択します。Robot Steps の処理スタックを選択するものではありません。

params.mplayer_stack
string

この Assembly でメタデータ抽出に使用する MPlayer スタックを選択します。Robot Steps の処理スタックを選択するものではありません。

params.nonce
string | number

各 Signature を一意にし、Signature の意図しない再利用を防ぐために、署名付きリクエストのパラメーターに含める一意のランダムな値。

params.notification_payload
Array<"without_params" | "without_result_meta_data" | "without_results" | "without_upload_meta_data" | "without_uploads">

Assembly Notifications で送信されるペイロードのサイズを制御します。Notification の再送では、元の Assembly リクエストで指定されたフィルターが再利用されます。Template 内でのみ定義されたフィルターは、再送時には保持されません。空の配列(デフォルト)を指定すると、完全な Assembly Status が送信されます。トップレベルの未加工の Assembly Instructions フィールド params、template、merged_params を省略するには、"without_params" を追加してください。results 内の各ファイルから meta を省略するには、"without_result_meta_data" を追加してください。トップレベルの results オブジェクトを省略するには、"without_results" を追加してください。uploads 内の各ファイルから meta を省略するには、"without_upload_meta_data" を追加してください。トップレベルの uploads 配列を省略するには、"without_uploads" を追加してください。フィルタリングはシリアライズ前に適用されるため、これらのオプションを使用するとメモリ使用量が減り、大規模な Assemblies でのペイロードのサイズ超過や OOM による失敗を回避しやすくなります。

配列要素のスキーマ
"without_params" | "without_result_meta_data" | "without_results" | "without_upload_meta_data" | "without_uploads"
params.notify_url
null | string

Transloadit は、Assembly が完了したときにサーバーへピングバックを送信できます。ここで指定された URL に、application/x-www-form-urlencoded の POST リクエストの transloadit フィールドで、Assembly Status を JSON 文字列として送信します。ペイロードのサイズを減らすには、notification_payload を使用してください(例: without_uploads、without_results、without_params)。Notification の再送時には、元の Assembly リクエストで指定されたフィルターのみが再利用され、Template でのみ定義されたフィルターは再利用されません。

params.quiet
boolean

Assembly 作成時の初期レスポンスを最小限に抑えるには、これを true に設定してください。成功時のレスポンスには ok と assembly_id のみが含まれます。エラーレスポンスでは、error、http_code、message、reason、および assembly_id が、利用可能な場合に保持されます。これはレスポンスの最小化であり、アクセス制御ではありません。返された Assembly ID を持つ人は誰でも、追加の認証なしで、フィールドと結果を含む完全な Assembly Status を引き続き取得できます。Assembly IDs とステータス URL は、秘密のケイパビリティとして扱ってください。notify_url が設定されている場合は、完全な Assembly Status が引き続き notify_url に送信されます。

params.redirect_url
string

ブラウザーからのアップロードが完了した後のリダイレクト先 URL。既存のクエリパラメーターとフラグメントを保持したまま、Assembly ID とステータス URL がクエリパラメーターとして追加されます。

params.response_headers
object

Assembly が出力する CORS レスポンスヘッダーです。以下に示す CORS ヘッダーを response_headers.cors 内、またはトップレベルに設定します。例: response_headers: { "cors": { "Access-Control-Allow-Origin": "https://example.com", "Access-Control-Allow-Methods": "GET, POST, OPTIONS" } }。ヘッダー名は大文字と小文字を区別しません。それ以外のヘッダー名と無効なヘッダー値は無視されます。コンテンツ、フレーミング、Cookie、リダイレクトは引き続き API によって制御されます。

params.response_headers: このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。

params.response_headers.cors
object

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.usage_tags
string

Assembly に記録された使用状況タグ。

次のいずれかのスキーマが適用される場合があります:

必須プロパティ: steps, template_id

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

フィールド型と説明
params.steps

必須

object

保存されている Template 内の指定された Steps にマージされる、部分的な Step 値です。これらの値の Robot 固有の完全な構造は、Template の読み込み後に検証されます。

追加プロパティのスキーマ
object

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.template_id

必須

string (最小長: 1)

Assembly Instructions を含む Template の ID です。Template で allow_steps_override を false に設定した場合、steps と template_id は相互に排他的となり、これらのパラメータのうち一方のみを指定できます。

バリアント 2

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

フィールド型と説明
params.input_url
string | Array<string>

template_id で選択した Builtin Template の入力ファイルとして、クライアントがアップロードする代わりに Transloadit がダウンロードする、1 件の HTTP(S) URL、または最大 10 件の URL のリストです。入力ファイルを受け付ける Builtin Templates のみがこれをサポートし、リクエストには署名または Bearer 認証が必要です。steps やアップロードと併用することはできません。URL はそのまま使用されます。絶対 URL で、4096 文字以内である必要があり、空白、|、${fields.url} などの Assembly Variables を含めてはいけません。プライベートネットワークのアドレスは拒否されます。

次のいずれかのスキーマが適用される場合があります:

string (最小長: 1, 最大長: 4096)
string
Array<string> (最小項目数: 1, 最大項目数: 10)
Array<string>
配列要素のスキーマ
string (最小長: 1, 最大長: 4096)
params.steps
object

Assembly Instructions を含みます。

追加プロパティのスキーマ
object

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.template_id
string

Assembly Instructions を含む Template の ID です。Template で allow_steps_override を false に設定した場合、steps と template_id は相互に排他的となり、これらのパラメータのうち一方のみを指定できます。

認証方式別のリクエストパラメーター

署名付き params

Auth Key を params.auth.key として含めてください。リクエストに署名する場合は、将来の時刻を示す params.auth.expires タイムスタンプを含め、Signature を別の signature フィールドで送信してください。以下のフィールド定義では、params 内のパスを使用しています。

完全な JSON スキーマ

JSON を新しいタブで開く

直接指定した Steps または Template から Assembly を作成する際に使用する署名付きパラメーター。

上記のフィールド定義を使用します: params.auth, params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

次のいずれかのスキーマが適用される場合があります:

必須プロパティ: steps, template_id

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

上記のフィールド定義を使用します: params.steps, params.template_id

バリアント 2

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

上記のフィールド定義を使用します: params.input_url, params.steps, params.template_id

Bearer トークンを使用する場合

Bearer トークンを Authorization ヘッダーで送信してください。params.auth と、それとは別の signature フィールドは省略できます。他の必須パラメーターの要件は引き続き適用されます。以下のフィールド定義では、params 内のパスを使用します。

完全な JSON スキーマ

JSON を新しいタブで開く

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

上記のフィールド定義を使用します: params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

フィールド型と説明
params.auth
object

Bearer 認証を使用する Assembly リクエストの認証メタデータとアップロードの制約です。トークンが API キーを提供するため、リクエストでは API キーを省略できます。

referer プロパティは、このアップロードの HTTP referer と照合する正規表現です。たとえば、"example\.org" のように指定します。指定された Referer の値が想定するドメインと一致するかを確認するために使用します。

referer のないアップロードは常にこのチェックを通過します(一部のブラウザーでは referer が無効になっているため)。そのため、この機能が役立つユースケースはごく限られます。正規表現の詳細については、Mozilla の RegExp ドキュメント⁠を参照してください。

無効な正規表現と、評価の制限時間を超える正規表現は拒否されます。このチェックは Signature Authentication の代わりにはなりません。クライアントは Referer ヘッダーを省略したり偽装したりできます。

auth.max_size プロパティは、各ファイルを個別に制限するのではなく、Assembly で想定されるアップロードの合計サイズをバイト単位で制限します。たとえば、1048576(1 MiB)のように指定します。このサイズには、マルチパートリクエストのボディ、または最初の Assembly リクエストのバイト数と、それに付随する再開可能なアップロードのバイト数の合計が含まれます。上限を超えると、個別には上限内に収まるファイルも含め、Assembly 全体がエラーで停止します。

上限は、保存済みの Template または Assembly リクエストの auth オブジェクトで設定してください。Signature を使用するブラウザーからのアップロードでは、バックエンドでユーザーを認証し、許可された上限と Template の選択を含む承認済みの Instructions のみに署名し、Signature Authentication を必須にしてください。Auth Secret と Assembly 作成用の Bearer トークンは、信頼できるバックエンドで保持してください。有効な Bearer 認証がある場合、Signature の必須要件は適用されません。保存済みの Template の上限は、リクエストの上限とは独立してチェックされます。アップロードのユーザーを検証する方法に従ってください。

この上限によって、サイズ超過のすべての転送を開始前に拒否できると考えないでください。再開可能なアップロードでは、申告されたサイズまたは受信済みのサイズが tus の更新を通じて利用可能になり、完了したアップロードが処理される際に Assembly が上限をチェックします。遅延アップロードのサイズは作成時には不明であり、Assembly がそのアップロードを拒否する前に、すでにデータが転送されている場合があります。

一定のサイズを超えるファイルだけを無視し、それ以外のすべてのファイルを処理したい場合は、🤖/file/filter を使用してください。

max_number_of_files プロパティを使用すると、1 回のアップロードに含められるファイル数の上限を設定できます。たとえば、100 のように指定します。ファイルアップロード経由でもインポート用 Robots 経由でも、ユーザーが過剰な数のファイルをアップロードすることを防ぐために、このプロパティを指定してください。

これらのプロパティは、Assembly リクエストの一部として、または Template の一部として設定できます。

params.auth: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

params.auth.expires
string

将来の日時を示す ISO 8601 形式の有効期限タイムスタンプ。リクエストが署名されている場合、または Signature Authentication が必要な場合は必須です。Bearer 認証を使用するリクエストでは省略できます。

params.auth.key
string

リクエストの認証に使用する Transloadit API キー

params.auth.max_number_of_files
integer (最小値: 1)

Assembly ごとに許可される入力ファイルの最大数です。アップロードまたはインポートされたファイルの数がこの上限を超えると、Assembly はエラーで停止します。これは、Signature Authentication の認証情報が露出した場合の不正利用を防ぐのに役立ちます。

params.auth.max_size
number

リクエストボディのオーバーヘッドを含む、Assembly で想定されるアップロードの合計サイズの上限(バイト単位)。これはファイルごとの制限ではなく、再開可能な転送が始まる前に拒否されることを保証するものではありません。

params.auth.referer
string

指定された HTTP Referer と照合する正規表現です。無効な式や、評価の制限時間を超える式は拒否されます。Referer ヘッダーがない場合は、このチェックを通過します。リクエストを認証するには Signature Authentication を使用してください。

次のいずれかのスキーマが適用される場合があります:

必須プロパティ: steps, template_id

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

上記のフィールド定義を使用します: params.steps, params.template_id

バリアント 2

直接指定した Steps または Template から Assembly を作成するためのパラメータ。

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

上記のフィールド定義を使用します: params.input_url, params.steps, params.template_id

ここでは、ほかの POST フィールド(params、signature、num_expected_upload_files、tus_num_expected_upload_files という名前ではないもの)も指定できます。これらは、Assembly Instructions を動的にするための変数として使用できます。

Builtin Template の入力を URL からインポートする

ファイルをアップロードする代わりに、Signature 付きまたは Bearer 認証済みのリクエストでは、以下に挙げる Builtin Template の template_id とともに、ファイルの URL を input_url に指定できます。Transloadit はファイルをダウンロードし、それらに対して Builtin の公開済み Steps を実行します。

{
  "template_id": "builtin/caption-video@0.0.1",
  "input_url": "https://example.com/videos/interview.mp4"
}

input_url は、1 つの HTTP(S) URL、または最大 10 個の URL のリストを受け付けます。builtin/caption-video は各動画をその動画の文字起こしと対応付けるため、Assembly ごとに 1 つの URL を受け取ります。リクエストに steps やアップロードを同時に含めることはできません。また、通常のインポート保護措置が適用されるため、プライベートネットワークのアドレスは拒否されます。Assembly では template_id と Builtin のフィールド検証が維持され、その Instructions ではインポートが imported Step として表示されます。この Assembly をリプレイすると、同じ URL が再度インポートされます。input_url を受け付ける Builtins: builtin/caption-video、builtin/convert-to-pdf、builtin/encode-video、builtin/extract-text、builtin/prepare-image、builtin/remove-background、builtin/transcribe、builtin/video-covers。

レスポンス

レスポンスボディの例を以下に示します:

{
  "account_id": "6c8b8d10d68b11e3a799b579dfce333a",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_url": "http://api2.morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "bytes_expected": 1687,
  "bytes_received": 1687,
  "bytes_usage": 0,
  "companion_url": "https://api2-morven.transloadit.com/companion/",
  "execution_duration": 0.001,
  "execution_start": "2018/05/30 08:47:19 GMT",
  "fields": {},
  "instance": "morven.transloadit.com",
  "jobs_queue_duration": 0,
  "message": "The Assembly is currently being executed.",
  "ok": "ASSEMBLY_EXECUTING",
  "parent_id": null,
  "queue_duration": 0.04,
  "results": {},
  "start_date": "2018/05/30 08:47:19 GMT",
  "template": null,
  "template_id": null,
  "tus_url": "https://api2-morven.transloadit.com/resumable/files/",
  "update_stream_url": "https://api2-morven.transloadit.com/ws20243?assembly=0fce5b1063e611e88d8eb130f7921d8a",
  "upload_duration": 0.049,
  "uploads": [],
  "uppyserver_url": "https://api2-morven.transloadit.com/companion/",
  "warnings": [],
  "websocket_url": "https://api2-morven.transloadit.com/ws20243"
}

2xx 成功

JSON レスポンスの本文。 application/json text/plain; charset=utf-8

レスポンスボディのスキーマ
完全な JSON スキーマ

JSON を新しいタブで開く

フィールド型と説明
account_id
null | string
account_name
null | string
account_slug
null | string
api_auth_key_id
null | string
assemblyId
string
assembly_id
string

この Assembly の一意の ID です。Assembly が作成されたときにこの ID をデータベースに保存し、受信する Notifications との照合に使用できます。

assembly_ssl_url
null | string

この Assembly の現在のステータスを照会するための一意の URL で、SSL/HTTPS 経由で使用できます。assembly_url に送信されるすべての API リクエストは、assembly_ssl_url にも送信できます。

assembly_url
null | string

この Assembly の現在のステータスを照会するために使用する一意の URL。

build_id
string

サポートによるトラブルシューティング用の、省略可能なビルド識別子です。不透明な値として扱ってください。Assemblies 間で変わる場合があります。

bytes_expected
number

この Assembly でアップロードされると見込まれるバイト数。

bytes_received
number

これまでにこの Assembly にアップロードされたバイト数です。これは主に、クライアントがアップロードの進行状況を表示するために使用します。

bytes_usage
number | null

この Assembly が処理したバイトのうち、利用料金の請求対象となるバイトの総数です。すべての Assemblies の bytes_usage の合計は、月間の総使用量と等しくなります。

client_agent
null | string

アップローダーのユーザーエージェントは公開されません。この非推奨フィールドは常に null です。

client_ip
null | string

アップロード元の IP アドレスは公開されません。この非推奨フィールドは常に null です。

client_referer
null | string

アップローダーのリファラー URL は公開されません。この非推奨のフィールドは常に null です。

companion_url
null | string

この Assembly が通信できる Companion サーバーの URL。

cron_input_file_limit
integer (最小値: 1, 最大値: 1000)

スケジュールされた Assembly の入力ファイル数に対する実効上限。クラッシュからの自動復旧では、保存済みの Instructions が無効になっている場合も、この上限が維持されます。通常の Assemblies では、このフィールドは省略されます。

executing_jobs
Array<string>
配列要素のスキーマ
string
execution_duration
number | null

Transloadit がこの Assembly の実行に要した時間(秒)。

execution_start
null | string
expected_tus_uploads
number
fields
object

Uppy など、<form> によるカプセル化を使用できないインテグレーション向けの、追加フォームフィールドのキー/値マップです。

追加プロパティのスキーマ
任意の値
finished_tus_uploads
number
has_dupe_jobs
boolean
ignored_error_count
number
ignored_errors
Array<object>
配列要素のスキーマ
object

ignored_errors[]: レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
ignored_errors[].error
任意の値
ignored_errors[].message
string
ignored_errors[].phase
string
ignored_errors[].step
null | string
info
object

info: レスポンスには追加のフィールドが含まれる場合があります。

info.retryIn
number
instance
null | string
is_infinite
boolean
jobs_queue_duration
number
last_job_completed
null | string
merged_params
null | string
message
string

この Assembly の状態を説明する、人が読んで理解できるメッセージです。必ずしも含まれるとは限りません。

notify_duration
number | null

自動再試行とその間の待機時間を含む、配信にかかった時間(秒)。

notify_error
null | string
notify_response_code
number | null
notify_response_data
null | string
notify_start
null | string
notify_status
null | string
notify_url
null | string
num_input_files
number
params
null | string
parent_assembly_status
任意の値 | null

次のいずれかのスキーマが適用される場合があります:

任意の値
任意の値
null
parent_id
null | string
previousStep
string

エラーに関連する前の Step の名前(取得可能な場合)。

queue_duration
number
region
string
results
object

Transloadit がこれまでに生成した結果ファイルです。各キーは、ファイルを生成した Step の名前です。ストレージ Robots はファイルを生成しないため、それらの Step 名は省略されます。error が発生した場合、このオブジェクトには部分的な結果が含まれることがあります。

追加プロパティのスキーマ
Array<object>

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

running_jobs
Array<string>
配列要素のスキーマ
string
start_date
string

この Assembly のアップロードが開始された日時。

started_jobs
Array<string>
配列要素のスキーマ
string
started_tus_uploads
number
step
string

エラーに関連付けられた Step の名前(取得可能な場合)。

template
null | string
template_id
null | string
template_name
null | string
transloadit_client
null | string
tus_uploads
Array<object>
配列要素のスキーマ
object

tus_uploads[]: レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
tus_uploads[].fieldname

必須

string
tus_uploads[].filename

必須

string
tus_uploads[].finished

必須

boolean
tus_uploads[].offset

必須

number
tus_uploads[].size

必須

number
tus_uploads[].upload_url

必須

string
tus_uploads[].user_meta
object

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

tus_url
string

この Assembly が再開可能なアップロードに使用する tus サーバーの URL。

update_stream_url
null | string

この Assembly のステータス更新をリアルタイムで取得できる、サーバー送信イベントストリームの URL。

upload_duration
number

アップローダーがファイルのアップロードに要した時間(秒)。

upload_meta_data_extracted
boolean
uploads
Array<object>

この Assembly 用にアップロードされたファイルの配列です。詳細については、メタデータのドキュメントを参照してください。

配列要素のスキーマ
object
フィールド型と説明
uploads[].as
string | Array<string> | null

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

uploads[].asset_id
string

/transloadit/store によって保存されたファイルの安定した識別子です。この識別子は、その Workspace および version_id とともに保持してください。通常のファイルの id は、ストレージ内のアセットの ID ではありません。

uploads[].asset_version
number

保存されたアセットのリビジョンを表す数値。保持されている正確なバイト列を選択するには、この数値ではなく version_id を使用してください。

uploads[].cost
number | null
uploads[].exec_time
number
uploads[].from_batch_import
boolean
uploads[].has_alpha
boolean

この保存済み画像バージョンにアルファチャンネルがあるかどうか(判明している場合)。

uploads[].import_url
string
uploads[].is_temp_url
boolean
uploads[].is_tus_file
boolean
uploads[].md5hash
null | string
uploads[].original_basename
null | string
uploads[].original_id

必須

string | Array<null | string>

このファイルの生成元となった元のアップロードファイルの一意の ID です。これは、いくつかの Steps の処理を経た後に、複数ファイルのアップロードのうち、特定のファイルの生成にどのファイルが使用されたかを判断するのに役立ちます。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

uploads[].original_md5hash
null | string
uploads[].original_name
null | string
uploads[].original_path
string
uploads[].queue
null | string
uploads[].queue_time
number
uploads[].sha256
string

保存されたバイト列の SHA-256 チェックサム(小文字、利用可能な場合)。

検証パターン(正規表現)^[a-f0-9]{64}$
uploads[].ssl_url
null | string
uploads[].thumbhash
string

利用可能な場合に、この保存済み画像バージョンとともに保持される Base64 エンコード済みの ThumbHash。この画像データは、元の画像と同じアクセス制御で保護してください。

検証パターン(正規表現)^(?:[A-Za-z0-9+/]{4}){1,15}(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)$
uploads[].tus_upload_url
null | string
uploads[].user_meta
object

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

uploads[].version_id
string

ストレージが結果を確定した後に返される不変のバージョン ID です。保持およびアクセスに関する条件の範囲内で、移動や上書きの後も同じバイト列を保持するには、asset_id とこの version_id を指定してインポートしてください。

検証パターン(正規表現)^[A-Za-z0-9_-]{21}[AQgw]$
uploads[].workspace
string (最小長: 1)

この保存済みの結果を所有する Workspace のスラッグです。この結果をインポートまたは管理する際は、この Workspace に対して認証してください。

次のいずれかのスキーマが適用される場合があります:

必須プロパティ: basename, ext, field, id, meta, mime, name, size, type, url: object
object

uploads[]: レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
uploads[].basename

必須

null | string

拡張子を除いたファイル名。

uploads[].ext

必須

null | string

ファイルの拡張子です。拡張子が判定されていない場合は null、名前に拡張子がない場合は空文字列になることがあります。

uploads[].field

必須

null | string

このファイルの送信に使用するフォームフィールドの名前。

uploads[].id

必須

string

Transloadit がファイルを追跡するために内部で使用する、ランダムかつ一意の ID。

uploads[].meta

必須

object

以下に示すような、ファイルから抽出された追加のメタデータを含むオブジェクトです。繰り返し現れる日付タグは、元の値のリストとして返されることがあります。値を単一のタイムスタンプとして使用する前に、その値の型を確認してください。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

uploads[].mime

必須

null | string

このファイルについて判定された MIME タイプ。

uploads[].name

必須

null | string

ファイルの名前です。ファイルが処理によって別の形式に変換される場合、Transloadit はこのフィールドで使用する拡張子を変更します。

uploads[].size

必須

number

ファイルのサイズ(バイト単位)。

uploads[].type

必須

null | string

ファイルを表す抽象的なカテゴリです。既知の値は "audio"、"document"、"image"、"office"、"pdf"、"swf"、"video"、"xls"、またはカテゴリが検出されなかった場合の null です。利用側は、将来のカテゴリとの互換性を保つため、他の文字列も受け入れるようにしてください。

uploads[].url

必須

null | string

ファイルをダウンロードできる URL、または配信用 URL が利用できない場合は null です。当社のサーバー上の一時的な URL は数時間後に有効期限が切れるため、後で使用するファイルはストレージにエクスポートしてください。/transloadit/store は、url/ssl_url に署名付きの Smart CDN URL を設定します。キーがない場合は null を設定します。アクセスおよび保持の条件に従って長期的に参照できるように、返された Workspace、asset_id、version_id を保持してください。/transloadit/import は、asset_id と任意の version_id、または変更される可能性のある path を受け付けます。一時的な URL も、処理対象ファイルの id も、長期的に利用できるストレージ参照ではありません。

バリアント 2: object
object

uploads[]: レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
uploads[].basename
null | string

拡張子を除いたファイル名。

uploads[].ext
null | string

ファイルの拡張子です。拡張子が判定されていない場合は null、名前に拡張子がない場合は空文字列になることがあります。

uploads[].field
null | string

このファイルの送信に使用するフォームフィールドの名前。

uploads[].id
なし

この値は禁止されています。

uploads[].meta
object

以下に示すような、ファイルから抽出された追加のメタデータを含むオブジェクトです。繰り返し現れる日付タグは、元の値のリストとして返されることがあります。値を単一のタイムスタンプとして使用する前に、その値の型を確認してください。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

uploads[].mime
null | string

このファイルについて判定された MIME タイプ。

uploads[].name
null | string

ファイルの名前です。ファイルが処理によって別の形式に変換される場合、Transloadit はこのフィールドで使用する拡張子を変更します。

uploads[].size
number

ファイルのサイズ(バイト単位)。

uploads[].type
null | string

ファイルを表す抽象的なカテゴリです。既知の値は "audio"、"document"、"image"、"office"、"pdf"、"swf"、"video"、"xls"、またはカテゴリが検出されなかった場合の null です。利用側は、将来のカテゴリとの互換性を保つため、他の文字列も受け入れるようにしてください。

uploads[].url
null | string

ファイルをダウンロードできる URL、または配信用 URL が利用できない場合は null です。当社のサーバー上の一時的な URL は数時間後に有効期限が切れるため、後で使用するファイルはストレージにエクスポートしてください。/transloadit/store は、url/ssl_url に署名付きの Smart CDN URL を設定します。キーがない場合は null を設定します。アクセスおよび保持の条件に従って長期的に参照できるように、返された Workspace、asset_id、version_id を保持してください。/transloadit/import は、asset_id と任意の version_id、または変更される可能性のある path を受け付けます。一時的な URL も、処理対象ファイルの id も、長期的に利用できるストレージ参照ではありません。

uppyserver_url
null | string
usage_tags
string
virusname
string
warnings
Array<object>
配列要素のスキーマ
object

warnings[]: レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
warnings[].action
object (必須プロパティ: message, text, type)

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

warnings[].code
string

警告を識別し、クライアントが msg を解析せずにその警告を認識できるようにします。コードがあるのは一部の警告のみで、プランのウォーターマークとプランによるメディアのトリミングに関する通知には、それぞれ PLAN_WATERMARK_APPLIED と PLAN_MEDIA_TRIM_APPLIED があります。新しいコードが追加される場合があります。不明なコードは、コードのない警告と同様に扱ってください。

warnings[].level

必須

"notice" | "warning"
warnings[].media_trim_duration_seconds
integer (最小値(境界値を含まない): 0, 最大値: 9007199254740991)

この実行に適用されたプランのメディア再生時間の上限(秒単位)。新しい PLAN_MEDIA_TRIM_APPLIED 通知に含まれます。古い通知ではこの項目が省略されています。現在のプランから時間を推測するのではなく、その通知の msg を使用してください。

warnings[].msg

必須

string
websocket_url
null | string

この Assembly のステータス更新をリアルタイムで取得できる Websocket(Socket.IO を使用)サーバーの URL。

次のいずれかのスキーマが適用される場合があります:

ok: "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
error
なし

エラーステータスを示します。このキーは、Assembly が失敗した場合にのみ存在します。新しいエラーコードが追加されることがあります。認識できないコードは失敗として処理し、プログラムで検査できるようにその値を保持してください。

この値は禁止されています。

ok

必須

"ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

エラーではないライフサイクルのステータスを示し、アップロード中、実行中、中止済み、キャンセル済みの状態が含まれます。処理の成功は ASSEMBLY_COMPLETED で示されます。Assembly でエラーが発生した場合は、このキーの代わりに以下の error キーが使用されます。

ok: string

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
error
なし

エラーステータスを示します。このキーは、Assembly が失敗した場合にのみ存在します。新しいエラーコードが追加されることがあります。認識できないコードは失敗として処理し、プログラムで検査できるようにその値を保持してください。

この値は禁止されています。

ok

必須

string

エラーではないライフサイクルのステータスを示し、アップロード中、実行中、中止済み、キャンセル済みの状態が含まれます。処理の成功は ASSEMBLY_COMPLETED で示されます。Assembly でエラーが発生した場合は、このキーの代わりに以下の error キーが使用されます。

指定可能な値 (6)
  • "ASSEMBLY_CANCELED"
  • "ASSEMBLY_COMPLETED"
  • "ASSEMBLY_EXECUTING"
  • "ASSEMBLY_REPLAYING"
  • "ASSEMBLY_UPLOADING"
  • "REQUEST_ABORTED"
必須プロパティ: error

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
cmd
string | Array<string | number>

トラブルシューティング用の処理コマンドの詳細情報です(省略可能)。診断情報の詳細は異なる場合があります。プログラムによるエラー処理には error コードを使用してください。

次のいずれかのスキーマが適用される場合があります:

string
Array<string | number>
Array<string | number>
配列要素のスキーマ
string | number
error

必須

string (最小長: 1)

エラーステータスを示します。このキーは、Assembly が失敗した場合にのみ存在します。新しいエラーコードが追加されることがあります。認識できないコードは失敗として処理し、プログラムで検査できるようにその値を保持してください。

既知の値(370)。その他の値もあり得ます
  • "ADMIN_PERMISSIONS_REQUIRED"
  • "AI_CHAT_VALIDATION"
  • "ASSEMBLY_ACCOUNT_MISMATCH"
  • "ASSEMBLY_CANNOT_BE_REPLAYED"
  • "ASSEMBLY_COULD_NOT_BE_CREATED"
  • "ASSEMBLY_CRASHED"
  • "ASSEMBLY_DISALLOWED_ROBOTS_USED"
  • "ASSEMBLY_EMPTY_STEPS"
  • "ASSEMBLY_EXECUTION_PROGRESS_NOT_ENABLED"
  • "ASSEMBLY_EXPIRED"
  • "ASSEMBLY_FILE_NOT_RESERVED"
  • "ASSEMBLY_INFINITE"
  • "ASSEMBLY_INVALID_NOTIFY_URL"
  • "ASSEMBLY_INVALID_NUM_EXPECTED_UPLOAD_FILES_PARAM"
  • "ASSEMBLY_INVALID_STEPS"
  • "ASSEMBLY_JOB_ENQUEUE_ERROR"
  • "ASSEMBLY_LIST_ERROR"
  • "ASSEMBLY_MEMORY_LIMIT_EXCEEDED"
  • "ASSEMBLY_NOTIFICATIONS_LIST_ERROR"
  • "ASSEMBLY_NOTIFICATION_LIST_ERROR"
  • "ASSEMBLY_NOTIFICATION_NOT_PERSISTED"
  • "ASSEMBLY_NOTIFICATION_NOT_REPLAYED"
  • "ASSEMBLY_NOT_CAPABLE"
  • "ASSEMBLY_NOT_FINISHED"
  • "ASSEMBLY_NOT_FOUND"
  • "ASSEMBLY_NOT_REPLAYED"
  • "ASSEMBLY_NO_CHARGEABLE_STEP"
  • "ASSEMBLY_NO_NOTIFY_URL"
  • "ASSEMBLY_NO_STEPS"
  • "ASSEMBLY_PLAN_FILE_SIZE_LIMIT_EXCEEDED"
  • "ASSEMBLY_ROBOT_MISSING"
  • "ASSEMBLY_SATURATED"
  • "ASSEMBLY_STATS_ERROR"
  • "ASSEMBLY_STATS_INVALID_TIME"
  • "ASSEMBLY_STATS_MISSING_REGION"
  • "ASSEMBLY_STATUS_FETCHING_RATE_LIMIT_REACHED"
  • "ASSEMBLY_STATUS_NOT_FOUND"
  • "ASSEMBLY_STATUS_PARSE_ERROR"
  • "ASSEMBLY_STEP_INVALID"
  • "ASSEMBLY_STEP_INVALID_ROBOT"
  • "ASSEMBLY_STEP_INVALID_USE"
  • "ASSEMBLY_STEP_NO_ROBOT"
  • "ASSEMBLY_STEP_UNKNOWN_ROBOT"
  • "ASSEMBLY_STEP_UNKNOWN_USE"
  • "ASSEMBLY_URL_TRANSFORM_MISSING"
  • "AUDIO_ARTWORK_VALIDATION"
  • "AUDIO_CONCAT_INVALID_INPUT"
  • "AUDIO_CONCAT_VALIDATION"
  • "AUDIO_ENCODE_VALIDATION"
  • "AUDIO_LOOP_VALIDATION"
  • "AUDIO_MERGE_VALIDATION"
  • "AUDIO_SPLIT_NO_OUTPUT"
  • "AUDIO_SPLIT_VALIDATION"
  • "AUDIO_WAVEFORM_VALIDATION"
  • "AUTH_EXPIRED"
  • "AUTH_KEYS_NOT_FOUND"
  • "AUTH_KEY_SCOPES_NOT_FOUND"
  • "AUTH_SECRET_NOT_RETRIEVED"
  • "AZURE_IMPORT_ACCESS_DENIED"
  • "AZURE_IMPORT_FAILURE"
  • "AZURE_IMPORT_NOT_FOUND"
  • "AZURE_IMPORT_VALIDATION"
  • "AZURE_STORE_ACCESS_DENIED"
  • "AZURE_STORE_NOT_FOUND"
  • "AZURE_STORE_VALIDATION"
  • "BACKBLAZE_IMPORT_ACCESS_DENIED"
  • "BACKBLAZE_IMPORT_FAILURE"
  • "BACKBLAZE_IMPORT_NOT_FOUND"
  • "BACKBLAZE_IMPORT_VALIDATION"
  • "BACKBLAZE_STORE_ACCESS_DENIED"
  • "BACKBLAZE_STORE_FAILURE"
  • "BACKBLAZE_STORE_VALIDATION"
  • "BAD_PRICING"
  • "BEARER_TOKEN_AUTH_KEY_MISMATCH"
  • "BEARER_TOKEN_EXPIRED"
  • "BEARER_TOKEN_INVALID"
  • "BILL_LIMIT_EXCEEDED"
  • "BOX_IMPORT_ACCESS_DENIED"
  • "BOX_IMPORT_FAILURE"
  • "BOX_IMPORT_NOT_FOUND"
  • "BOX_IMPORT_VALIDATION"
  • "BOX_STORE_COULD_NOT_PARSE_URL"
  • "BOX_STORE_VALIDATION"
  • "CANNOT_ACCEPT_NEW_ASSEMBLIES"
  • "CDN_REQUIRED"
  • "CLOUDFILES_IMPORT_ACCESS_DENIED"
  • "CLOUDFILES_IMPORT_FAILURE"
  • "CLOUDFILES_IMPORT_NOT_FOUND"
  • "CLOUDFILES_IMPORT_VALIDATION"
  • "CLOUDFILES_STORE_ACCESS_DENIED"
  • "CLOUDFILES_STORE_ERROR"
  • "CLOUDFILES_STORE_VALIDATION"
  • "CLOUDFLARE_IMPORT_ACCESS_DENIED"
  • "CLOUDFLARE_IMPORT_FAILURE"
  • "CLOUDFLARE_IMPORT_NOT_FOUND"
  • "CLOUDFLARE_IMPORT_VALIDATION"
  • "CLOUDFLARE_STORE_ACCESS_DENIED"
  • "CLOUDFLARE_STORE_NOT_FOUND"
  • "CLOUDFLARE_STORE_URL_VERIFICATION_FAILURE"
  • "CLOUDFLARE_STORE_VALIDATION"
  • "CLOUDFLARE_STORE_WRONG_REGION"
  • "CLOUD_AI_IMAGE_VALIDATION"
  • "DAM_STORAGE_UNAVAILABLE"
  • "DIGITALOCEAN_IMPORT_ACCESS_DENIED"
  • "DIGITALOCEAN_IMPORT_FAILURE"
  • "DIGITALOCEAN_IMPORT_NOT_FOUND"
  • "DIGITALOCEAN_IMPORT_VALIDATION"
  • "DIGITALOCEAN_STORE_ACCESS_DENIED"
  • "DIGITALOCEAN_STORE_NOT_FOUND"
  • "DIGITALOCEAN_STORE_VALIDATION"
  • "DIGITALOCEAN_STORE_WRONG_REGION"
  • "DOCUMENT_AUTOROTATE_VALIDATION"
  • "DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION"
  • "DOCUMENT_CONVERT_VALIDATION"
  • "DOCUMENT_EXTRACT_VALIDATION"
  • "DOCUMENT_MERGE_UNSUPPORTED_CONVERSION"
  • "DOCUMENT_MERGE_VALIDATION"
  • "DOCUMENT_OCR_VALIDATION"
  • "DOCUMENT_OPTIMIZE_UNSUPPORTED_INPUT"
  • "DOCUMENT_OPTIMIZE_VALIDATION"
  • "DOCUMENT_SPLIT_VALIDATION"
  • "DOCUMENT_THUMBS_INVALID_INPUT"
  • "DOCUMENT_THUMBS_VALIDATION"
  • "DOCUMENT_WATERMARK_INVALID_INPUT"
  • "DOCUMENT_WATERMARK_INVALID_LAYOUT"
  • "DOCUMENT_WATERMARK_UNSUPPORTED_TEXT"
  • "DOCUMENT_WATERMARK_VALIDATION"
  • "DO_NOT_REUSE_ASSEMBLY_IDS"
  • "DROPBOX_IMPORT_ACCESS_DENIED"
  • "DROPBOX_IMPORT_FAILURE"
  • "DROPBOX_IMPORT_NOT_FOUND"
  • "DROPBOX_IMPORT_VALIDATION"
  • "DROPBOX_STORE_COULD_NOT_PARSE_URL"
  • "DROPBOX_STORE_VALIDATION"
  • "FILE_COMPRESS_INVALID_INPUT"
  • "FILE_COMPRESS_VALIDATION"
  • "FILE_DECOMPRESS_INVALID_INPUT"
  • "FILE_DECOMPRESS_PASSWORD_INCORRECT"
  • "FILE_DECOMPRESS_PASSWORD_REQUIRED"
  • "FILE_DECOMPRESS_VALIDATION"
  • "FILE_DOWNLOAD_ERROR"
  • "FILE_FILTER_DECLINED_FILE"
  • "FILE_FILTER_INVALID_OPERATOR"
  • "FILE_FILTER_VALIDATION"
  • "FILE_HASH_VALIDATION"
  • "FILE_META_DATA_ERROR"
  • "FILE_PREVIEW_VALIDATION"
  • "FILE_READ_VALIDATION_ERROR"
  • "FILE_SERVE_NO_RESULT"
  • "FILE_SERVE_VALIDATION"
  • "FILE_VERIFY_INVALID_FILE"
  • "FILE_VERIFY_VALIDATION"
  • "FILE_VIRUSSCAN_DECLINED_FILE"
  • "FILE_VIRUSSCAN_INVALID_INPUT"
  • "FILE_VIRUSSCAN_VALIDATION"
  • "FTP_IMPORT_ACCESS_DENIED"
  • "FTP_IMPORT_FAILURE"
  • "FTP_IMPORT_NOT_FOUND"
  • "FTP_IMPORT_VALIDATION"
  • "FTP_STORE_VALIDATION"
  • "GET_ACCOUNT_DB_ERROR"
  • "GET_ACCOUNT_UNKNOWN_AUTH_KEY"
  • "GOOGLE_IMPORT_ACCESS_DENIED"
  • "GOOGLE_IMPORT_FAILURE"
  • "GOOGLE_IMPORT_NOT_FOUND"
  • "GOOGLE_IMPORT_VALIDATION"
  • "GOOGLE_STORE_ACCESS_DENIED"
  • "GOOGLE_STORE_INVALID_INPUT"
  • "GOOGLE_STORE_VALIDATION"
  • "HTML_CONVERT_VALIDATION"
  • "HTTP_IMPORT_ACCESS_DENIED"
  • "HTTP_IMPORT_FAILURE"
  • "HTTP_IMPORT_NOT_FOUND"
  • "HTTP_IMPORT_VALIDATION"
  • "HTTP_REQUEST_FAILURE"
  • "HTTP_REQUEST_VALIDATION"
  • "IMAGE_BGREMOVE_VALIDATION"
  • "IMAGE_COPYRIGHT_DETECT_DECLINED_FILE"
  • "IMAGE_COPYRIGHT_DETECT_VALIDATION"
  • "IMAGE_DESCRIBE_VALIDATION"
  • "IMAGE_ENHANCE_NO_INPUT_FILE"
  • "IMAGE_ENHANCE_VALIDATION"
  • "IMAGE_FACEDETECT_VALIDATION"
  • "IMAGE_GENERATE_VALIDATION"
  • "IMAGE_MERGE_FAILURE"
  • "IMAGE_MERGE_VALIDATION"
  • "IMAGE_OCR_VALIDATION"
  • "IMAGE_OPTIMIZE_VALIDATION"
  • "IMAGE_RESIZE_ERROR"
  • "IMAGE_RESIZE_INVALID_BLUR_REGION"
  • "IMAGE_RESIZE_INVALID_TEXT_OBJECT_VALUE"
  • "IMAGE_RESIZE_INVALID_TEXT_VALUE"
  • "IMAGE_RESIZE_INVALID_WATERMARK_OFFSET"
  • "IMAGE_RESIZE_INVALID_WATERMARK_POSITION"
  • "IMAGE_RESIZE_NO_CLUT_FILE"
  • "IMAGE_RESIZE_NO_INPUT_FILE"
  • "IMAGE_RESIZE_VALIDATION"
  • "IMAGE_UPSCALE_VALIDATION"
  • "IMPORT_FILE_ERROR"
  • "INCOMPLETE_PRICING"
  • "INSUFFICIENT_AUTH_SCOPE"
  • "INTERNAL_COMMAND_ERROR"
  • "INTERNAL_COMMAND_TIMEOUT"
  • "INVALID_ASSEMBLY_STATUS"
  • "INVALID_AUTH_EXPIRES_PARAMETER"
  • "INVALID_AUTH_KEY_PARAMETER"
  • "INVALID_AUTH_MAX_NUMBER_OF_FILES_PARAMETER"
  • "INVALID_AUTH_MAX_SIZE_PARAMETER"
  • "INVALID_AUTH_REFERER_PARAMETER"
  • "INVALID_FILE_META_DATA"
  • "INVALID_FORM_DATA"
  • "INVALID_INPUT_ERROR"
  • "INVALID_PARAMS_FIELD"
  • "INVALID_SIGNATURE"
  • "INVALID_STEP_NAME"
  • "INVALID_TEMPLATE_FIELD"
  • "INVALID_UPLOAD_HANDLE_STEP_NAME"
  • "INVALID_URL_ENCODING"
  • "MAX_NUMBER_OF_FILES_EXCEEDED"
  • "MAX_SIZE_EXCEEDED"
  • "MEGA_IMPORT_ACCESS_DENIED"
  • "MEGA_IMPORT_FAILURE"
  • "MEGA_IMPORT_NOT_FOUND"
  • "MEGA_IMPORT_VALIDATION"
  • "MEGA_STORE_ACCESS_DENIED"
  • "MEGA_STORE_NOT_FOUND"
  • "MEGA_STORE_VALIDATION"
  • "MEGA_STORE_WRONG_REGION"
  • "META_WRITE_VALIDATION"
  • "MINIO_IMPORT_ACCESS_DENIED"
  • "MINIO_IMPORT_FAILURE"
  • "MINIO_IMPORT_NOT_FOUND"
  • "MINIO_IMPORT_VALIDATION"
  • "MINIO_STORE_ACCESS_DENIED"
  • "MINIO_STORE_NOT_FOUND"
  • "MINIO_STORE_VALIDATION"
  • "MINIO_STORE_WRONG_REGION"
  • "NO_AUTH_EXPIRES_PARAMETER"
  • "NO_AUTH_KEY_PARAMETER"
  • "NO_AUTH_PARAMETER"
  • "NO_COUNTRY"
  • "NO_OBJECT_AUTH_PARAMETER"
  • "NO_OBJECT_PARAMS_FIELD"
  • "NO_PARAMS_FIELD"
  • "NO_PRICING"
  • "NO_RESULT_STEP_FOUND"
  • "NO_RPC_RESULT_FROM_IMAGE_RESIZER"
  • "NO_SIGNATURE_FIELD"
  • "NO_TEMPLATE_ID"
  • "PLAN_LIMIT_EXCEEDED"
  • "POSSIBLY_MALICIOUS_FILE_FOUND"
  • "PRIORITY_JOB_SLOTS_NOT_FOUND"
  • "PRIORITY_JOB_SLOT_STATS_ERROR"
  • "PRIORITY_JOB_SLOT_STATS_INVALID_AGGREGATION"
  • "PRIORITY_JOB_SLOT_STATS_INVALID_TIME"
  • "PRIORITY_JOB_SLOT_STATS_MISSING_REGION"
  • "RATE_LIMIT_REACHED"
  • "REFERER_MISMATCH"
  • "REQUEST_PREMATURE_CLOSED"
  • "ROBOT_NOT_AVAILABLE_FOR_CLIENT"
  • "ROBOT_VALIDATION_BASE_ERROR"
  • "S3_ACCESS_DENIED"
  • "S3_IMPORT_ACCESS_DENIED"
  • "S3_IMPORT_FAILURE"
  • "S3_IMPORT_NOT_FOUND"
  • "S3_IMPORT_VALIDATION"
  • "S3_NOT_FOUND"
  • "S3_STORE_ACCESS_DENIED"
  • "S3_STORE_FAILURE"
  • "S3_STORE_NOT_FOUND"
  • "S3_STORE_URL_VERIFICATION_FAILURE"
  • "S3_STORE_VALIDATION"
  • "S3_STORE_WRONG_REGION"
  • "S3_WRONG_REGION"
  • "SCRIPT_RUN_VALIDATION"
  • "SERVER_403"
  • "SERVER_404"
  • "SERVER_500"
  • "SFTP_IMPORT_ACCESS_DENIED"
  • "SFTP_IMPORT_FAILURE"
  • "SFTP_IMPORT_NOT_FOUND"
  • "SFTP_IMPORT_VALIDATION"
  • "SFTP_STORE_VALIDATION"
  • "SIGNATURE_REUSE_DETECTED"
  • "SPEECH_TRANSCRIBE_VALIDATION"
  • "STORAGE_GRANT_NOT_CREATED"
  • "SUPABASE_IMPORT_ACCESS_DENIED"
  • "SUPABASE_IMPORT_FAILURE"
  • "SUPABASE_IMPORT_NOT_FOUND"
  • "SUPABASE_IMPORT_VALIDATION"
  • "SUPABASE_STORE_ACCESS_DENIED"
  • "SUPABASE_STORE_NOT_FOUND"
  • "SUPABASE_STORE_VALIDATION"
  • "SUPABASE_STORE_WRONG_REGION"
  • "SWIFT_IMPORT_ACCESS_DENIED"
  • "SWIFT_IMPORT_FAILURE"
  • "SWIFT_IMPORT_NOT_FOUND"
  • "SWIFT_IMPORT_VALIDATION"
  • "SWIFT_STORE_ACCESS_DENIED"
  • "SWIFT_STORE_NOT_FOUND"
  • "SWIFT_STORE_VALIDATION"
  • "SWIFT_STORE_WRONG_REGION"
  • "TEMPLATE_CREDENTIALS_INJECTION_ERROR"
  • "TEMPLATE_DB_ERROR"
  • "TEMPLATE_DENIES_STEPS_OVERRIDE"
  • "TEMPLATE_INVALID_JSON"
  • "TEMPLATE_NOT_FOUND"
  • "TEXT_SPEAK_VALIDATION"
  • "TEXT_TRANSLATE_VALIDATION"
  • "TIGRIS_IMPORT_ACCESS_DENIED"
  • "TIGRIS_IMPORT_FAILURE"
  • "TIGRIS_IMPORT_NOT_FOUND"
  • "TIGRIS_IMPORT_VALIDATION"
  • "TIGRIS_STORE_ACCESS_DENIED"
  • "TIGRIS_STORE_NOT_FOUND"
  • "TIGRIS_STORE_VALIDATION"
  • "TIGRIS_STORE_WRONG_REGION"
  • "TMP_FILE_DOWNLOAD_ERROR"
  • "TMP_FILE_UPLOAD_ERROR"
  • "TOKEN_INVALID_CREDENTIALS"
  • "TRANSIENT_STORAGE_SERVICE_ERROR"
  • "TRANSLOADIT_IMPORT_ACCESS_DENIED"
  • "TRANSLOADIT_IMPORT_FAILURE"
  • "TRANSLOADIT_IMPORT_NOT_FOUND"
  • "TRANSLOADIT_IMPORT_VALIDATION"
  • "TRANSLOADIT_STORE_CONFLICT"
  • "TRANSLOADIT_STORE_FAILURE"
  • "TRANSLOADIT_STORE_UNAVAILABLE"
  • "TRANSLOADIT_STORE_VALIDATION"
  • "TUS_STORE_VALIDATION"
  • "USER_COMMAND_ERROR"
  • "VERIFIED_EMAIL_REQUIRED"
  • "VIDEO_ADAPTIVE_VALIDATION"
  • "VIDEO_ARTWORK_VALIDATION"
  • "VIDEO_CONCAT_INVALID_INPUT"
  • "VIDEO_CONCAT_NO_OUTPUT"
  • "VIDEO_CONCAT_VALIDATION"
  • "VIDEO_ENCODE_INVALID_VIDEO_CODEC"
  • "VIDEO_ENCODE_INVALID_WATERMARK_POSITION"
  • "VIDEO_ENCODE_VALIDATION"
  • "VIDEO_GENERATE_VALIDATION"
  • "VIDEO_MERGE_NO_IMAGE_FOUND"
  • "VIDEO_MERGE_VALIDATION"
  • "VIDEO_ONDEMAND_NOT_FOUND"
  • "VIDEO_ONDEMAND_VALIDATION"
  • "VIDEO_SPLIT_NO_OUTPUT"
  • "VIDEO_SPLIT_VALIDATION"
  • "VIDEO_SUBTITLE_VALIDATION"
  • "VIDEO_THUMBS_INVALID_COUNT_VALUE"
  • "VIDEO_THUMBS_INVALID_FORMAT"
  • "VIDEO_THUMBS_INVALID_INPUT"
  • "VIDEO_THUMBS_VALIDATION"
  • "VIMEO_IMPORT_ACCESS_DENIED"
  • "VIMEO_IMPORT_FAILURE"
  • "VIMEO_IMPORT_NOT_FOUND"
  • "VIMEO_IMPORT_VALIDATION"
  • "VIMEO_STORE_ACCESS_DENIED"
  • "VIMEO_STORE_PROBLEM_SENDING_FILE"
  • "VIMEO_STORE_VALIDATION"
  • "WASABI_IMPORT_ACCESS_DENIED"
  • "WASABI_IMPORT_FAILURE"
  • "WASABI_IMPORT_NOT_FOUND"
  • "WASABI_IMPORT_VALIDATION"
  • "WASABI_STORE_ACCESS_DENIED"
  • "WASABI_STORE_NOT_FOUND"
  • "WASABI_STORE_VALIDATION"
  • "WASABI_STORE_WRONG_REGION"
  • "WORKER_JOB_ERROR"
  • "YOUTUBE_STORE_PROBLEM_SENDING_FILE"
  • "YOUTUBE_STORE_VALIDATION"
exitCode
number | null

失敗した処理コマンドの終了ステータス(省略可能)。診断の詳細は異なる場合があります。プログラムによるエラー処理には error コードを使用してください。

exitSignal
null | string

処理コマンドを終了させたシグナル(省略可能)。診断の詳細は異なる場合があります。プログラムによるエラー処理には error コードを使用してください。

file
string
headers
object
追加プロパティのスキーマ
任意の値
is_private_address
boolean
name
string
numRetries
number
ok
null
playwright_error_code
string
reason
null | string | number | boolean | Array<任意の値> | object

省略可能な診断の詳細情報です。この値が文字列であると仮定したり、そのまま表示したりしないでください。人が読めるテキストには message を使用してください。診断の詳細情報は変わることがあります。プログラムによるエラー処理には error コードを使用してください。

次のいずれかのスキーマが適用される場合があります:

null
string
number
boolean
Array<任意の値>
Array<任意の値>
配列要素のスキーマ
任意の値
object
object
追加プロパティのスキーマ
任意の値
response_code
number | null
retries
number
retryable
boolean
stderr
string

トラブルシューティング用の、処理コマンドからの診断出力です(省略可能)。診断の詳細は変わる場合があります。プログラムによるエラー処理には error コードを使用してください。

stdout
string

トラブルシューティング用の、処理コマンドからの標準出力です(省略可能)。診断情報の詳細は異なる場合があります。プログラムによるエラー処理には error コードを使用してください。

url
string
url_host
null | string

エラーレスポンス

JSON レスポンスの本文。 application/json text/plain; charset=utf-8

レスポンスボディのスキーマ
完全な JSON スキーマ

JSON を新しいタブで開く

次のプロパティのうち、少なくとも 1 つが必須です: error, message, reason

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
assembly_id
string
error
string (最小長: 1)
http_code
number | string
  • number
  • string
    検証パターン(正規表現)^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*[+-]?0*(?:0(?:[^0-9]|$)|(?:[1-9][0-9]{0,307}|1(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-5][0-9]{4}|7976[0-8][0-9]{3}|79769[0-2][0-9]{2}|7976930[0-9]{1}|7976931[0-2])[0-9]{300}|79769313(?:(?:[0-3][0-9]{7}|4[0-7][0-9]{6}|48[0-5][0-9]{5}|486[0-1][0-9]{4}|4862[0-2][0-9]{3}|486230[0-9]{2}|486231[0-4][0-9]{1}|4862315[0-7])[0-9]{292}|48623158(?:(?:0[0-6][0-9]{6}|07[0-8][0-9]{5}|079[0-2][0-9]{4}|0793[0-6][0-9]{3}|07937[0-1][0-9]{2}|079372[0-7][0-9]{1}|0793728[0-8])[0-9]{284}|07937289(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-3][0-9]{5}|7140[0-4][0-9]{3}|71405[0-2][0-9]{2}|7140530[0-2])[0-9]{276}|71405303(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-4][0-9]{5}|4150[0-6][0-9]{3}|41507[0-8][0-9]{2}|415079[0-8][0-9]{1}|4150799[0-2])[0-9]{268}|41507993(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-2][0-9]{5}|413[0-1][0-9]{4}|4132[0-6][0-9]{3}|413270[0-9]{2})[0-9]{260}|41327100(?:(?:[0-2][0-9]{7}|3[0-6][0-9]{6}|37[0-7][0-9]{5}|378[0-1][0-9]{4}|3782[0-5][0-9]{3}|37826[0-8][0-9]{2}|378269[0-2][0-9]{1}|3782693[0-5])[0-9]{252}|37826936(?:(?:0[0-9]{7}|1[0-6][0-9]{6}|17[0-2][0-9]{5}|173[0-6][0-9]{4}|1737[0-6][0-9]{3}|17377[0-7][0-9]{2}|173778[0-8][0-9]{1}|1737789[0-7])[0-9]{244}|17377898(?:(?:0[0-3][0-9]{6}|04[0-3][0-9]{5}|044[0-3][0-9]{4}|0444[0-8][0-9]{3}|04449[0-5][0-9]{2}|044496[0-7][0-9]{1}|0444968[0-1])[0-9]{236}|04449682(?:(?:[0-8][0-9]{7}|9[0-1][0-9]{6}|92[0-6][0-9]{5}|927[0-5][0-9]{4}|9276[0-3][0-9]{3}|92764[0-6][0-9]{2}|927647[0-4][0-9]{1})[0-9]{228}|92764750(?:(?:[0-8][0-9]{7}|9[0-3][0-9]{6}|94[0-5][0-9]{5}|946[0-5][0-9]{4}|9466[0-3][0-9]{3}|94664[0-8][0-9]{2}|94664900)[0-9]{220}|94664901(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-6][0-9]{4}|7977[0-4][0-9]{3}|79775[0-7][0-9]{2}|797758[0-6][0-9]{1}|7977587[0-1])[0-9]{212}|79775872(?:(?:0[0-6][0-9]{6}|070[0-8][0-9]{4}|0709[0-5][0-9]{3}|07096[0-2][0-9]{2}|070963[0-2][0-9]{1})[0-9]{204}|07096330(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-5][0-9]{5}|286[0-3][0-9]{4}|28640[0-9]{3}|28641[0-5][0-9]{2}|286416[0-5][0-9]{1}|2864166[0-8])[0-9]{196}|28641669(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-7][0-9]{5}|288[0-6][0-9]{4}|2887[0-8][0-9]{3}|288790[0-9]{2}|2887910[0-8])[0-9]{188}|28879109(?:(?:[0-3][0-9]{7}|4[0-5][0-9]{6}|46[0-4][0-9]{5}|465[0-4][0-9]{4}|4655[0-4][0-9]{3}|46555[0-4][0-9]{2}|465555[0-3][0-9]{1}|4655554[0-6])[0-9]{180}|46555547(?:(?:[0-7][0-9]{7}|8[0-4][0-9]{6}|850[0-9]{5}|851[0-8][0-9]{4}|8519[0-3][0-9]{3}|851940[0-3][0-9]{1})[0-9]{172}|85194040(?:(?:[0-1][0-9]{7}|2[0-5][0-9]{6}|26[0-2][0-9]{5}|2630[0-5][0-9]{3}|26306[0-4][0-9]{2}|263065[0-6][0-9]{1}|2630657[0-3])[0-9]{164}|26306574(?:(?:[0-7][0-9]{7}|8[0-7][0-9]{6}|88[0-5][0-9]{5}|886[0-6][0-9]{4}|88670[0-9]{3}|88671[0-4][0-9]{2}|8867150[0-4])[0-9]{156}|88671505(?:(?:[0-7][0-9]{7}|8[0-1][0-9]{6}|820[0-5][0-9]{4}|8206[0-7][0-9]{3}|820680[0-9]{2}|820681[0-8][0-9]{1})[0-9]{148}|82068190(?:(?:[0-7][0-9]{7}|8[0-8][0-9]{6}|890[0-1][0-9]{4}|8902000[0-6])[0-9]{140}|89020007(?:(?:0[0-7][0-9]{6}|08[0-2][0-9]{5}|083[0-7][0-9]{4}|0838[0-2][0-9]{3}|08383[0-5][0-9]{2}|083836[0-6][0-9]{1}|0838367[0-5])[0-9]{132}|08383676(?:(?:[0-1][0-9]{7}|2[0-6][0-9]{6}|27[0-2][0-9]{5}|273[0-7][0-9]{4}|2738[0-4][0-9]{3}|27385[0-3][0-9]{2}|273854[0-7][0-9]{1}|2738548[0-3])[0-9]{124}|27385484(?:(?:[0-4][0-9]{7}|5[0-7][0-9]{6}|580[0-9]{5}|581[0-6][0-9]{4}|5817[0-6][0-9]{3}|581770[0-9]{2}|5817710[0-9]{1}|5817711[0-4])[0-9]{116}|58177115(?:(?:[0-2][0-9]{7}|30[0-9]{6}|31[0-6][0-9]{5}|317[0-5][0-9]{4}|3176[0-3][0-9]{3}|31764[0-3][0-9]{2}|317644[0-6][0-9]{1}|3176447[0-4])[0-9]{108}|31764475(?:(?:[0-6][0-9]{7}|7[0-2][0-9]{6}|730[0-1][0-9]{4}|7302[0-6][0-9]{3}|7302700[0-5])[0-9]{100}|73027006(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-4][0-9]{5}|985[0-4][0-9]{4}|9855[0-4][0-9]{3}|98555[0-6][0-9]{2}|9855570[0-9]{1}|9855571[0-2])[0-9]{92}|98555713(?:(?:[0-5][0-9]{7}|6[0-5][0-9]{6}|66[0-8][0-9]{5}|669[0-4][0-9]{4}|6695[0-8][0-9]{3}|66959[0-5][0-9]{2}|669596[0-1][0-9]{1}|6695962[0-1])[0-9]{84}|66959622(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-1][0-9]{5}|842[0-8][0-9]{4}|84290[0-9]{3}|84291[0-3][0-9]{2}|842914[0-7][0-9]{1}|84291480)[0-9]{76}|84291481(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-5][0-9]{5}|9860[0-7][0-9]{3}|98608[0-2][0-9]{2}|986083[0-3][0-9]{1}|9860834[0-8])[0-9]{68}|98608349(?:(?:[0-2][0-9]{7}|3[0-5][0-9]{6}|36[0-3][0-9]{5}|364[0-6][0-9]{4}|3647[0-4][0-9]{3}|36475[0-1][0-9]{2}|364752[0-8][0-9]{1}|3647529[0-1])[0-9]{60}|36475292(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-8][0-9]{5}|7190[0-6][0-9]{3}|71907[0-3][0-9]{2}|7190740[0-9]{1}|7190741[0-5])[0-9]{52}|71907416(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-3][0-9]{5}|844[0-3][0-9]{4}|8444[0-2][0-9]{3}|84443[0-5][0-9]{2}|844436[0-4][0-9]{1}|8444365[0-4])[0-9]{44}|84443655(?:(?:0[0-9]{7}|10[0-6][0-9]{5}|1070[0-3][0-9]{3}|10704[0-2][0-9]{2}|107043[0-3][0-9]{1}|1070434[0-1])[0-9]{36}|10704342(?:(?:[0-6][0-9]{7}|70[0-9]{6}|710[0-9]{5}|711[0-4][0-9]{4}|7115[0-4][0-9]{3}|71155[0-8][0-9]{2}|711559[0-5][0-9]{1}|7115596[0-8])[0-9]{28}|71155969(?:(?:[0-8][0-9]{7}|9[0-4][0-9]{6}|950[0-7][0-9]{4}|95080[0-8][0-9]{2}|950809[0-2][0-9]{1})[0-9]{20}|95080930(?:(?:[0-3][0-9]{7}|4[0-1][0-9]{6}|42[0-7][0-9]{5}|428[0-7][0-9]{4}|428800[0-9]{2}|428801[0-6][0-9]{1}|4288017[0-6])[0-9]{12}|42880177(?:(?:[0-8][0-9]{7}|90[0-3][0-9]{5}|9040[0-9]{4}|9041[0-6][0-9]{3}|90417[0-3][0-9]{2}|904174[0-3][0-9]{1}|9041744[0-8])[0-9]{4}|90417449(?:(?:[0-6][0-9]{3}|7[0-6][0-9]{2}|77[0-8][0-9]{1}|7790)|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]|$))
message
string

人が読んで理解できる形式のエラー説明です。文言は変わる場合があるため、特定の失敗を処理する際は error コードを使用してください。

reason
null | string | number | boolean | Array<任意の値> | object

次のいずれかのスキーマが適用される場合があります:

null
string
number
boolean
Array<任意の値>
Array<任意の値>
配列要素のスキーマ
任意の値
object
object
追加プロパティのスキーマ
任意の値

HTTP 400

JSON レスポンスの本文。 application/json text/plain; charset=utf-8

レスポンスボディのスキーマ
完全な JSON スキーマ

JSON を新しいタブで開く

名前付きエラーと一般的なエラー形式

error: "INVALID_PARAMS_FIELD"

不正な params フィールドが指定されました。無効な JSON が含まれています。

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
error

必須

string (常に: "INVALID_PARAMS_FIELD")
http_code
number (常に: 400)
message
string

人が読んで理解できる形式のエラー説明です。文言は変わる場合があるため、特定の失敗を処理する際は error コードを使用してください。

一般的なエラー形式

一般的なエラーレスポンスのフィールドを参照してください。

レスポンスの詳細については、Assembly Status レスポンスのドキュメントを参照してください。

前のページ ← Auth Key のシークレットを取得する次のページ Assembly Status を取得する →
サポートに問い合わせる
Transloadit稼働状況を確認中…

製品

  • サービス
  • 料金
  • デモ EN (English)
  • ツール
  • セキュリティ
  • サポート

会社

  • 会社概要/プレス
  • ブログ/採用情報 EN (English)
  • 比較/コンプライアンス対応表
  • 研究 EN (English)
  • オープンソース
  • ソリューション
  • ウェブの先駆者たち

ドキュメント

  • はじめに
  • トランスコーディング
  • よくある質問
  • API
  • ガイド EN (English)/開発のヒント
  • 対応フォーマット

その他

  • プラットフォームの稼働状況⁠
  • コミュニティフォーラム⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®、tus®、Uppy® は、米国における Transloadit-II GmbH の登録商標です。

プライバシー EN (English)利用規約 EN (English)運営者情報 EN (English)商標 EN (English)DMCA ポリシー EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語