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 アップロードをダウンロードする

サポートされている範囲指定レスポンスを含め、再開可能なアップロードからバイトデータをダウンロードします。

GET{UPLOAD_URL}
補足

create-upload の成功レスポンスの Location ヘッダーにあるアップロード用のケイパビリティ URL を使用してください。この URL では、API2 ホストに関連付けられた暗黙的に利用可能な認証情報は使用しません。

このエンドポイントは、アップロードが未完了でも、それまでに受信したバイトをダウンロードします。成功を示す HTTP 200 または 206 レスポンスは、アップロードが完了したことを意味しません。受信済みのバイトがないアップロードでは、空のボディを伴う HTTP 200 が返される場合があります。範囲レスポンスの場合、Content-Range 内のサイズは現在保存されているサイズであり、宣言されたアップロードの最終的な長さではありません。

完了したアップロードをダウンロードする前に、そのオフセットを取得してください。Upload-Length が存在し、Upload-Offset が Upload-Length と等しいことを確認してください。Upload-Defer-Length: 1 は、全体の長さがまだ不明であり、転送が完了していないことを意味します。

Assembly の処理とエクスポートの成功は、この tus 転送の完了とは別です。処理済みのアセットを公開する前に、最終的な Assembly Status とその結果を確認してください。

リクエスト例

tus アップロードの作成時に返される完全な Location URL を UPLOAD_URL に設定してください。この URL は秘密にしてください。

curl --fail-with-body -sS --request GET \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --output './download.bin'

リクエストヘッダー

完全な JSON スキーマ

JSON を新しいタブで開く

tusd のダウンロード拡張機能用に小文字へ正規化されたヘッダー。

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

フィールド型と説明
if-match
string (最小長: 1, 最大長: 8192)

アップロードが一致する必要のあるエンティティタグまたはワイルドカード。

if-modified-since
string (最小長: 1, 最大長: 8192)

その日時より後に変更されたアップロードが返される HTTP 日付。

if-none-match
string (最小長: 1, 最大長: 8192)

アップロードが一致してはならないエンティティタグまたはワイルドカード。

if-range
string (最小長: 1, 最大長: 8192)

バイト範囲を条件付きにするエンティティタグまたは HTTP 日付。

if-unmodified-since
string (最小長: 1, 最大長: 8192)

アップロードがその日時より後に変更されている場合、事前条件を満たさなくなる HTTP 日時。

range
string (最大長: 8192)

1 つ以上の正規のバイト範囲。

検証パターン(正規表現)^bytes=(?:[0-9]+-[0-9]*|-[0-9]+)(?:,(?:[0-9]+-[0-9]*|-[0-9]+))*$
tus-resumable
string (常に: "1.0.0")

クライアントが指定した場合の、ネゴシエーションで決定された tus のバージョン。

レスポンス

HTTP 200

バイナリ形式のレスポンスボディ。 */*

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

JSON を新しいタブで開く

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

フィールド型と説明
accept-ranges

必須

string (常に: "bytes")
content-disposition

必須

string (最小長: 1)
content-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)$
content-type

必須

string
検証パターン(正規表現)^[a-z]+\/[a-z0-9+.-]+$
last-modified

必須

string (最小長: 1)
tus-resumable

必須

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

必須

string (常に: "nosniff")

HTTP 206

バイナリ形式のレスポンスボディ。 */*

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

JSON を新しいタブで開く

フィールド型と説明
accept-ranges

必須

string (常に: "bytes")
content-disposition

必須

string (最小長: 1)
content-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)$
last-modified

必須

string (最小長: 1)
tus-resumable

必須

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

必須

string (常に: "nosniff")

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

必須プロパティ: content-range, content-type

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

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

必須

string

返されたバイト範囲(両端を含む)と現在の保存済みサイズであり、宣言された最終アップロード長ではありません。

検証パターン(正規表現)^bytes [0-9]+-[0-9]+\/[0-9]+$
content-type

必須

string
検証パターン(正規表現)^[a-z]+\/[a-z0-9+.-]+$
必須プロパティ: content-type

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

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

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

content-type

必須

string
検証パターン(正規表現)^multipart\/byteranges; boundary=[0-9a-f]{60}$

HTTP 304

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

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

JSON を新しいタブで開く

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

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

必須

string (最小長: 1)
last-modified

必須

string (最小長: 1)
tus-resumable

必須

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

必須

string (常に: "nosniff")

HTTP 412

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

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

JSON を新しいタブで開く

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

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

必須

string (最小長: 1)
content-type

必須

string
検証パターン(正規表現)^[a-z]+\/[a-z0-9+.-]+$
last-modified

必須

string (最小長: 1)
tus-resumable

必須

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

必須

string (常に: "nosniff")

HTTP 416

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

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

JSON を新しいタブで開く

"invalid range: failed to overlap\n" | "invalid range\n"
レスポンスヘッダー
完全な JSON スキーマ

JSON を新しいタブで開く

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

必須

string (最小長: 1)
content-type

必須

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

必須

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

必須

string (常に: "nosniff")

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

必須プロパティ: content-range

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

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

必須

string

充足されないバイト範囲に対する現在の保存済みサイズであり、宣言されたアップロードの最終的な長さではありません。

検証パターン(正規表現)^bytes [*]\/[0-9]+$
バリアント 2

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

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

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

エラーレスポンス

テキスト形式のレスポンスボディ。 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 アップロードを終了する次のページ 新しい Template 認証情報を作成する →
サポートに問い合わせる
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)日本語