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
  • ストレージ内のアセットを取得
  • ストレージ内のアセットを一覧表示

tus アップロードを作成する

検証済みの Assembly メタデータから、再開可能なアップロードリソースを作成します。

POST{TUS_URL}
補足

検証済みの Assembly レスポンスに含まれる tus_url ケイパビリティ URL をリクエスト先として使用します。API2 ホストに関連付けられ、暗黙的に利用可能な認証情報は使用しません。

通常の固定サイズのアップロードでは、まず num_expected_upload_files をファイル数に設定して Assembly を作成します。返された assembly_ssl_url と tus_url を以下の例にコピーしてください。返された tus_url を汎用の API ホスト名で置き換えないでください。

この例では 4 バイトを予約してから、テキスト file をアップロードします。実際のファイルでは、そのファイルのバイト長を使用し、PATCH リクエストでそのバイト列を送信してください。

assembly_ssl_url='<assembly_ssl_url from the creation response>'
tus_url='<tus_url from the creation response>'
assembly_metadata=$(printf %s "$assembly_ssl_url" | base64 | tr -d "\n")

curl --fail-with-body -sS --include --request POST \
  --url "$tus_url" \
  --header 'tus-resumable: 1.0.0' \
  --header 'upload-length: 4' \
  --header "upload-metadata: assembly_url $assembly_metadata,filename ZmlsZS50eHQ=,fieldname ZmlsZQ=="

成功した 201 レスポンスでは、location ヘッダーにアップロード URL が返されます。その URL を以下にコピーしてください。転送が中断された場合に、サーバーが報告するオフセットから再開できるよう、その URL を保持してください。

upload_url='<Location response header>'
curl --fail-with-body -sS --request PATCH \
  --url "$upload_url" \
  --header 'tus-resumable: 1.0.0' \
  --header 'upload-offset: 0' \
  --header 'content-type: application/offset+octet-stream' \
  --data-binary 'file'

復旧と完了については、再開可能なアップロードガイドを参照してください。長さの後指定、連結、正確なヘッダー構文については、以下で説明します。

並列アップロードでは、部分リソースを作成し、そのバイト列をアップロードしてから、それらを連結する最終リソースを作成します。最終ファイルだけが Assembly の入力となり、Template によって処理されます。num_expected_upload_files は、部分リソースの数ではなく、最終ファイルの数に設定してください。すべての部分リソースおよび最終リソースの作成リクエストに、assembly_url、filename、fieldname のメタデータを含めてください。tus-js-client で parallelUploads を使用する場合は、これらのフィールドを metadataForPartialUploads にも指定してください。

通常のアップロードでは、Upload-Concat を含めないでください。各部分リソースの作成リクエストでは、これを partial に設定してください。すべての部分アップロードが完了したら、次の指定で最終リソースを作成します。

Upload-Concat: final;<PARTIAL_UPLOAD_URL_1> <PARTIAL_UPLOAD_URL_2>

プレースホルダーを、部分アップロードで返された完全な Location URL に置き換えてください。final の直後のセミコロンは残し、URL はスペースで区切ってください。URL の順序によって、最終ファイル内のバイトの順序が決まります。

認証

同じ検証済みの Assembly レスポンスに含まれる assembly_ssl_url の Base64 エンコード済みの値を指定して、assembly_url を Upload-Metadata ヘッダーで送信してください。

リクエストヘッダー

完全な JSON スキーマ

JSON を新しいタブで開く

固定長、長さ指定延期、部分、または最終の tus アップロードの作成に使用する、小文字に正規化されたヘッダー。

フィールド型と説明
tus-resumable

必須

string (常に: "1.0.0")

ネゴシエーションで合意された tus のバージョン。

upload-metadata

必須

string

標準 Base64 の値を任意で付けられる、カンマ区切りの ASCII メタデータキー。成功した Transloadit アップロードには filename と fieldname が含まれます。認証メタデータはトランスポートによって組み立てられます。

検証パターン(正規表現)^[\x21-\x2b\x2d-\x7e]+(?: (?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?)?(?:,[\x21-\x2b\x2d-\x7e]+(?: (?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?)?)*$

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

必須プロパティ: upload-length

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

フィールド型と説明
content-type
string (常に: "application/offset+octet-stream")
upload-concat
string (常に: "partial")
upload-defer-length
なし

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

upload-length

必須

string

符号付き 64 ビット整数の範囲内にある、ゼロ埋めやプラス記号を含まない正規形式の符号なし 10 進数で表されるバイト数。

検証パターン(正規表現)^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$
upload-defer-length: "1"

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

フィールド型と説明
content-type
string (常に: "application/offset+octet-stream")
upload-concat
string (常に: "partial")
upload-defer-length

必須

string (常に: "1")
upload-length
なし

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

必須プロパティ: upload-concat

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

フィールド型と説明
content-type
なし

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

upload-concat

必須

string (最大長: 8192)
検証パターン(正規表現)^final;(?:https?:\/\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+)?\/resumable\/files\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+(?:\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+)*(?: (?:https?:\/\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+)?\/resumable\/files\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+(?:\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+)*)*$
upload-defer-length
なし

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

upload-length
なし

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

リクエストボディ

バイナリ形式のリクエストボディ。 application/offset+octet-stream ボディは省略可能です。

レスポンス

HTTP 201

レスポンスボディはありません。

レスポンスヘッダー
完全な JSON スキーマ

JSON を新しいタブで開く

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

フィールド型と説明
location

必須

string (最小長: 1)

新しいアップロードリソースの URL です。クライアントは、返されたケイパビリティとしてこの URL を検証する必要があります。

tus-resumable

必須

string (常に: "1.0.0")
upload-offset
string

符号付き 64 ビット整数の範囲内にある、ゼロ埋めやプラス記号を含まない正規形式の符号なし 10 進数で表されるバイト数。

検証パターン(正規表現)^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$
x-content-type-options

必須

string (常に: "nosniff")

エラーレスポンス

テキスト形式のレスポンスボディ。 text/plain; charset=utf-8

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

JSON を新しいタブで開く

string

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

バリアント 1: string
string
検証パターン(正規表現)^ERR_[A-Z0-9_]+: [^\r\n]*\n$
バリアント 2: string
string

ペイロードをそのまま含む、生の text/plain フックエラー形式。JSON のような構造ですが、必ずしも有効な JSON とは限りません。

検証パターン(正規表現)^\{"error":"(?:[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]|[^\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff])*"\}$
レスポンスヘッダー
完全な JSON スキーマ

JSON を新しいタブで開く

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

フィールド型と説明
content-type

必須

string (常に: "text/plain; charset=utf-8")
tus-resumable

必須

string (常に: "1.0.0")
x-content-type-options

必須

string (常に: "nosniff")
前のページ ← tus の機能を確認する次のページ tus アップロードのオフセットを取得する →
サポートに問い合わせる
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)日本語