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 Instructions の中で、steps と同じ階層に notify_url を設定してください。Assembly が終端状態に達すると、Transloadit はその URL に HTTP POST を送信します。

200 以上 300 未満のステータスはいずれも配信の受領確認となります。リダイレクト、およびクライアントエラーやサーバーエラーは失敗として扱われます。デフォルトでは、Transloadit は失敗した配信を指数係数 1.97 で 5 回再試行します。

受領確認は受信を確認するものであり、処理の成功を確認するものではありません。検証済みペイロードの ok の状態または error コードを調べて、Assemblies の完了、キャンセル、失敗を区別してください。Notification の再送では、終端状態ではない Assembly Status が配信されることもあります。すべての配信が完了を意味すると想定しないでください。

Notification のペイロードを制限する

デフォルトでは、ウェブフックには完全な Assembly Status が含まれます。notification_payload を、次のサポートされているフィルターを任意に組み合わせた配列に設定してください。

  • without_params: トップレベルの未加工の Assembly Instructions フィールドである params、template、merged_params が省略されます。
  • without_result_meta_data: results 内の各ファイルから meta が省略されます。
  • without_results: トップレベルの results オブジェクトが省略されます。
  • without_upload_meta_data: uploads 内の各ファイルから meta が省略されます。
  • without_uploads: トップレベルの uploads 配列が省略されます。

Notification の再送では、元の Assembly リクエストで指定されたフィルターが再利用されます。Template 内でのみ定義されたフィルターは再送時に維持されないため、再送には初回の Notification で省略されたデータが含まれる場合があります。再送でも同じフィルターを使用する必要がある場合は、元の Assembly リクエストで notification_payload を指定してください。

以下のペイロードスキーマでは、これらの省略が許可されています。アップロードが uploads に残っていても、そのアップロードの meta が存在しない場合があります。その他のフィールドは、Assembly Status における意味を維持します。互換性のため、追加されるフィールドを受け入れてください。ただし、文書化されていない診断用フィールドには依存しないでください。

Signature を検証する

Assembly のウェブフックは、application/x-www-form-urlencoded メディアタイプを使用します。transloadit フィールドにはシリアライズされたそのままの Assembly Status JSON が含まれ、signature フィールドには、その小文字の 16 進数表記の HMAC が含まれます。

ウェブフックを検証するには、次の手順に従ってください。

  1. ペイロード文字列を変更せずに、transloadit と signature のフォームフィールドを読み取ります。
  2. 以下の説明に従って選択した信頼できる Auth Secret を使用し、正確な transloadit 文字列のバイト列に対して HMAC-SHA1 の 16 進数ダイジェストを計算します。
  3. タイミング攻撃に対して安全な比較を使用して、計算したダイジェストを signature と比較します。
  4. Signatures が一致した後にのみ、transloadit を JSON として解析します。

Assembly の初回の Notification は、その作成を認証した Auth Key の Auth Secret を使用します。これは、Assembly Replayによって作成された場合も同様です。Notification の再送では、最初に Assembly Status に api_auth_key_id として記録されている Auth Key を検索します。そのキーが記録されていない、解決できない、削除されている、または検索に失敗した場合、Notification の再送では代わりに、認証済みの再送呼び出し元の Auth Secret を使用します。

Assembly Replays は、親の過去の api_auth_key_id を保持します。たとえば、キー A が Assembly を作成し、キー B がそれを再実行した場合、新しい Assembly の初回の Notification は B のシークレットで署名されます。その Notification を再送する際には、B が両方の再実行・再送エンドポイントを呼び出し、両方のキーが引き続き有効であっても、A のシークレットが使用される場合があります。適用される親のシークレットと再実行による作成時のシークレットを、検証処理で使用できるようにしておいてください。1 つの Assembly のすべての配信で同じシークレットが使用されるとは想定しないでください。

検証用のシークレットは、未検証のペイロード内のフィールドからではなく、想定している Workspace と Assembly 用の信頼できるサーバー側設定から選択してください。設定済みのシークレットが複数適用される場合は、リクエストの Signature がそれらの信頼できるシークレットのいずれかと一致する場合にのみ、リクエストを受け入れてください。どれとも一致しない場合は、リクエストを拒否してください。再送を受け入れるために検証を省略しないでください。

現在の API リクエスト用の Signatures とは異なり、ウェブフックの signature は、後方互換性のためにプレフィックスのない sha1 ダイジェストとなっています。ペイロードは信頼できないものとして扱い、いずれかのフィールドが存在しない場合、Signature の形式が不正な場合、または比較が失敗した場合は、リクエストを拒否してください。

利用可能な場合は、当社の SDK の検証ヘルパーを使用してください。検証を自分で実装する場合は、HMAC を計算する前に解析済みの JSON を再シリアライズしないでください。空白とオブジェクトのキーの順序は、署名対象のバイト列の一部です。

import { createHmac, timingSafeEqual } from 'node:crypto'

// authSecret must come from trusted server-side configuration.
function verifyTransloaditWebhook({ authSecret, payload, signature }) {
  if (typeof payload !== 'string' || typeof signature !== 'string') return false
  if (!/^[0-9a-f]+$/.test(signature)) return false

  const expected = createHmac('sha1', authSecret).update(payload, 'utf8').digest()
  if (signature.length !== expected.length * 2) return false
  const received = Buffer.from(signature, 'hex')

  return received.length === expected.length && timingSafeEqual(received, expected)
}

より強力な Signature を有効にする

Auth Key を作成または更新する際に、notification_signature_algo を sha256 または sha384 に設定してください。この設定は、API リクエストへの署名を制御するキーの signature_algo とは独立しています。既存のキーと新しいキーのデフォルトは null です。更新時にこの設定を省略すると現在の設定が維持され、null に設定すると追加のヘッダーが無効になります。

この設定を有効にしたキーでは、sha256:<lowercase hex digest> または sha384:<lowercase hex digest> を含む Transloadit-Signature ヘッダーが追加されます。従来の signature フォームフィールドは変更されません。両方の Signatures は、デコード済みの transloadit フォームフィールド内にある、フィルター適用後の正確な JSON 文字列の、URL エンコード前の UTF-8 バイト列を署名対象とします。エンコード済みの HTTP 本文に署名したり、検証前に JSON を解析して再シリアライズしたりしないでください。

初回の Notifications は、Assembly の認証時に読み込まれたキー設定を使用します。キーを変更しても、すでに進行中の Assemblies は変更されません。明示的な Notification の再送では、記録されたキーの現在のシークレットと Notification 用アルゴリズムを一緒に検索します。過去のキーの検索で上記のフォールバックが発生した場合は、呼び出し元の設定が一緒に使用されます。自動再試行では、その配信で選択されたアルゴリズムとシリアライズ済みのペイロードが維持されます。

新しいヘッダーを有効にする前に、そのヘッダーに対応した検証処理をデプロイしてください。連携側でより強力な Signature を必須にしたら、ヘッダーが存在しない場合や無効な場合は拒否し、検証処理に設定されたもの以外のアルゴリズムも拒否してください。SHA-1 フィールドに暗黙にフォールバックしてはいけません。移行時は、まずすべての Notification 送信側と再送ハンドラーをデプロイしてください。キー設定のキャッシュが更新され、以前の Assemblies が完了するのを待ち、変更後に作成された Assemblies の配信でヘッダーが届くことを確認してから、ヘッダーを必須にしてください。受信側でヘッダーを必須にした後は、送信側のロールフォワードを優先してください。受信側で従来方式のみの Notifications との互換性を先に復元しない限り、送信側を従来方式のみのビルドにロールバックすると、配信できなくなります。

import { createHmac, timingSafeEqual } from 'node:crypto'

// expectedAlgorithm and authSecret come from trusted server-side configuration.
function verifyStrongTransloaditWebhook({ authSecret, expectedAlgorithm, payload, signature }) {
  if (expectedAlgorithm !== 'sha256' && expectedAlgorithm !== 'sha384') return false
  if (typeof payload !== 'string' || typeof signature !== 'string') return false
  const prefix = `${expectedAlgorithm}:`
  if (!signature.startsWith(prefix)) return false
  const hex = signature.slice(prefix.length)
  if (!/^[0-9a-f]+$/.test(hex)) return false
  const expected = createHmac(expectedAlgorithm, authSecret).update(payload, 'utf8').digest()
  if (hex.length !== expected.length * 2) return false
  return timingSafeEqual(Buffer.from(hex, 'hex'), expected)
}

Signature の検証はペイロードを認証しますが、重複配信を防ぐものではありません。検証済みの Assembly の識別情報とアプリケーション自身の状態を使用して、処理を冪等にしてください。

ウェブフックのフォームフィールド

完全な JSON スキーマ

JSON を新しいタブで開く

Transloadit は、このオブジェクトについて記載されているフィールドのみを送信します。

フィールド型と説明
signature

必須

string

transloadit 文字列の正確なバイト列に対する HMAC-SHA1 を、アルゴリズムのプレフィックスなしで小文字の16進数として表記したものです。信頼できる Auth Secret を使用し、タイミングセーフな比較を行ってください。

検証パターン(正規表現)^[0-9a-f]{40}$
transloadit

必須

string

フィルタリング済みの Assembly Status の正確な JSON テキストです。JSON として解析する前に、この文字列を一切変更せず、その正確なバイト列を対象に Signature を検証してください。

検証済み JSON ペイロード

完全な 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[]: Transloadit は追加のフィールドを送信することがあります。

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

info: Transloadit は追加のフィールドを送信することがあります。

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[]: Transloadit は追加のフィールドを送信することがあります。

フィールド型と説明
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[].meta
object

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

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

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, mime, name, size, type, url: object
object

uploads[]: Transloadit は追加のフィールドを送信することがあります。

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

必須

null | string

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

uploads[].ext

必須

null | string

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

uploads[].field

必須

null | string

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

uploads[].id

必須

string

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

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[]: Transloadit は追加のフィールドを送信することがあります。

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

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

uploads[].ext
null | string

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

uploads[].field
null | string

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

uploads[].id
なし

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

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[]: Transloadit は追加のフィールドを送信することがあります。

フィールド型と説明
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"

Transloadit は追加のフィールドを送信することがあります。

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

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

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

ok

必須

"ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

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

ok: string

Transloadit は追加のフィールドを送信することがあります。

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

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

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

ok

必須

string

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

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

Transloadit は追加のフィールドを送信することがあります。

フィールド型と説明
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
前のページ ← 認証次のページ メタデータ →
サポートに問い合わせる
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)日本語