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

Bearer トークンを作成する

Auth Key の認証情報を、スコープを限定した Bearer トークンと交換します。

POSThttps://api2.transloadit.com/token

これは OAuth 2.0 のトークンエンドポイントです。ヘッドレスクライアントは、client_credentials グラントを使用して Auth Key と Auth Secret を短寿命の Bearer トークンと交換します。この処理は Transloadit API が直接行います。URL で接続した MCP クライアントは、authorization_code グラントを使用してコンソールの同意画面から取得した認可コードを引き換えます(PKCE S256、HTTP Basic 認証情報なし)。また、refresh_token グラントを使用して、得られたリフレッシュトークンをローテーションします。

/token では、authorization_code と refresh_token の OAuth グラントエラーに、標準の error と error_description を含むレスポンスボディを使用します。レート制限では RATE_LIMIT_REACHED (429) が返され、予期しない内部障害では SERVER_500 (500) が返されます。グラントが特定される前に拒否された不正な形式のリクエストには、HTTP Basic チャレンジ (401)、または Basic 認証情報が指定されていた場合は TOKEN_INVALID_REQUEST が返されることがあります。

クライアント認証情報によるトークンは、Auth Key/Secret を使用してサーバー側で発行されます。UI からトークンを作成できるようにする場合は、バックエンドから /token を呼び出してください(ブラウザーから直接呼び出すことは決してしないでください)。

キャンセル済みの Workspaces では、新しい Bearer トークンを作成できません。キャンセル後の読み取りがドキュメントで明示的に許可されているエンドポイントでは、代わりに既存の有効な Auth Key を使用して、署名付き読み取りの手順に従ってください。請求については、専用の署名付きアクセスの手順があります。

リクエストには application/x-www-form-urlencoded を使用する必要があります。client_credentials グラントには HTTP Basic 認証も必要です。

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

この例では、Assembly の読み取りと書き込みのアクセス権を要求し、同じシェルでの後続のリクエストに使用するため、返された access_token を TRANSLOADIT_TOKEN として保存します。別のエンドポイントを使用する場合は、代わりにそのエンドポイントに記載されているスコープを使用してください。その Auth Key で、それらのスコープがすでに許可されている必要があります。Auth Key または Bearer トークンで認証するエンドポイントでは、リクエスト例に適切なトークン設定が含まれています。

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:read 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

認証

次の grant_type の値には、Auth Key とシークレットを使用した HTTP Basic 認証が必要です: client_credentials。サポートされているその他の値には、アカウントの認証情報は必要ありません。それらのリクエストでは Authorization ヘッダーを送信しないでください。ただし、グラント固有の証明は引き続き必要です。

フォームフィールド

コンテンツタイプ: application/x-www-form-urlencoded

次のフィールドは、それぞれ最大 1 回送信できます: aud, client_assertion, client_assertion_type, client_id, client_secret, code, code_verifier, grant_type, redirect_uri, refresh_token, resource, scope。

完全な JSON スキーマ

JSON を新しいタブで開く

クライアント認証情報、認可コード、リフレッシュトークンの各グラント用の OAuth 2.0 トークンリクエストフォーム。

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

フィールド型と説明
aud
string

client_credentials 用の省略可能な audience 値です。省略した場合、デプロイ環境に設定されたデフォルト値が使用されます(上書きされていなければ api2)。その他のグラントでは、resource から audience が導出されます。

client_assertion
string

クライアントの公開済みの鍵のいずれかで署名された JWT(RFC 7523)で、メタデータで private_key_jwt が許可されているクライアントからのものです。あるグラントのトークンリクエストに一度このような JWT が含まれると、そのグラントに対する以後のすべてのリクエストにも含める必要があります。その iss と sub はクライアント ID です。その aud は、このデプロイメントに設定されたトークンエンドポイント URL またはそのオリジン(末尾のスラッシュなし)であり、この JWT は 5 分以内に有効期限が切れます。各 jti は、アサーションが有効な間、クライアントごと、リージョンごとに 1 回だけ受け付けられます。リクエストごとに新しい jti を使用してください。

client_assertion_type
string

client_assertion が送信される場合は、常に urn:ietf:params:oauth:client-assertion-type:jwt-bearer です。

client_id
string

動的登録によるクライアント識別子、またはクライアントのメタデータドキュメントの HTTPS URL。client_assertion でクライアントが指定されている場合を除き、authorization_code と refresh_token では必須です。

client_secret
string

client_secret_basic または client_secret_post を使用した動的登録で発行されたクライアントシークレットで、client_id とともに送信します。これらのフォームフィールドの代わりに、クライアントは HTTP Basic 認証を通じて client_id と client_secret を送信することもできますが、1 回のリクエストで両方の方法を使用することはできません。シークレットを発行されたクライアントは、すべての authorization_code リクエスト、refresh_token リクエスト、および失効リクエストで、そのシークレットを提示する必要があります。

code
string

同意後にクライアントのリダイレクト URI に送信される、一度限りの認可コード。authorization_code の場合は必須です。

code_verifier
string

認可開始時に SHA-256 ダイジェストが code_challenge として送信された PKCE コードベリファイア。authorization_code の場合は必須です。

grant_type

必須

"authorization_code" | "client_credentials" | "refresh_token"

実行する OAuth 2.0 のグラント。client_credentials は HTTP Basic 認証で提供された Auth Key の認証情報を交換し、authorization_code はコンソールでの同意後に発行されたコードをその PKCE 検証子とともに引き換え、refresh_token はグラントのリフレッシュトークンを使ってそのグラントを更新します。後者の 2 つのグラントでは、HTTP Basic 認証情報を送信するのは、client_secret_basic で登録された OAuth クライアントのみです。

redirect_uri
string

認可リクエストで使用するリダイレクト URI。authorization_code の場合は必須です。

refresh_token
string

認可グラントのリフレッシュトークン。refresh_token の場合は必須です。クライアントシークレットを持たないクライアントでは、新しいペアが発行されると、提示されたトークンは使用できなくなります。クライアントシークレットで認証するクライアントには、同じリフレッシュトークンが返されます。

resource
string

トークンの対象となる保護リソースで、ホストされた MCP エンドポイント(aud=mcp)または API オリジン自体(aud=api2)です。省略した場合は、認可コードまたはリフレッシュトークンの発行対象となったリソースが使用されます。指定する場合は、そのリソースと一致する必要があります。

scope
string

client_credentials 用のスコープをスペースまたはカンマで区切ったリストです(任意)。省略した場合、トークンは Auth Key に付与されているすべてのスコープを継承します。他のグラントでは、同意時に付与されたスコープが維持されます。

トークンの使用

API リクエストでは、トークンを Authorization: Bearer <access_token> として渡してください。有効な Bearer トークンでリクエストが認証されると、API2 は Signature Authentication が満たされているとみなし、Signature の検証をスキップします。Signature Authentication が必須となるのは、キー/シークレットを使用するリクエストのみです。スコープのチェックは引き続き適用されます。デフォルトの api2 オーディエンスは通常の API2 エンドポイントで受け入れられ、デフォルトで 21,600 秒間有効です。mcp オーディエンスは MCP サーバーで受け入れられ、MCP サーバーはサービス認証情報を使用してこれを API2 に中継します。通常の API2 エンドポイントに直接提示された場合は拒否され、デフォルトで 604,800 秒間有効です。レスポンスの expires_in の値を正としてください。

レスポンス

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

{
  "access_token": "opaque-token",
  "expires_in": 21600,
  "scope": "assemblies:read assemblies:write",
  "token_type": "Bearer"
}

2xx 成功

JSON レスポンスの本文。 application/json

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

JSON を新しいタブで開く

レスポンスには、このオブジェクトについて記載されているフィールドのみが含まれます。

フィールド型と説明
access_token

必須

string (最小長: 1)

後続の API リクエストの Authorization ヘッダーで送信するトークンです。秘密にしてください。

expires_in

必須

integer (最小値(境界値を含まない): 0)

発行時点からのトークンの有効期間(秒単位)。有効期限が切れたら、新しいトークンをリクエストしてください。

refresh_token
string (最小長: 1)

authorization_code および refresh_token グラントで返されます。新しいアクセストークンを取得するには、これを grant_type=refresh_token とともに POST /token に提示します。クライアントシークレットを持たないクライアントでは、使用するたびにこのトークンがローテーションされ、ローテーション済みのトークンを再使用すると、その系統全体が失効します。クライアントシークレットで認証するクライアントには、同じリフレッシュトークンが返され、使用するたびにその有効期間が延長されます。

scope

必須

string (最小長: 1, 最大長: 512)

このトークンに付与されたスコープ(スペース区切り)。

検証パターン(正規表現)^(?:read|write|auth_keys:write|auth_keys:read|assemblies:write|assemblies:read|assembly_notifications:write|dam:read|dam:write|template_credentials:read|template_credentials:write|billing:read|queues:read|smart_cdn:sign|templates:read|templates:write|storage_grants:write)(?: (?:read|write|auth_keys:write|auth_keys:read|assemblies:write|assemblies:read|assembly_notifications:write|dam:read|dam:write|template_credentials:read|template_credentials:write|billing:read|queues:read|smart_cdn:sign|templates:read|templates:write|storage_grants:write))*$
token_type

必須

string (常に: "Bearer")

HTTP 400

JSON レスポンスの本文。 application/json

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

JSON を新しいタブで開く

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

error: "GET_ACCOUNT_UNKNOWN_AUTH_KEY"

Workspace を取得できませんでした。これは不明な Auth Key です。

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

フィールド型と説明
error

必須

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

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

error: "TOKEN_INVALID_GRANT_TYPE"

グラントタイプが無効です。

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

フィールド型と説明
error

必須

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

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

error: "TOKEN_INVALID_REQUEST"

トークンリクエストが無効です。

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

フィールド型と説明
error

必須

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

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

必須プロパティ: error

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

フィールド型と説明
error

必須

string

RFC 6749、7591、または 8707 のエラーコード(invalid_grant など)。

検証パターン(正規表現)^(?:access_denied|invalid_client|invalid_client_metadata|invalid_grant|invalid_redirect_uri|invalid_request|invalid_scope|invalid_target|server_error|unauthorized_client|unsupported_grant_type)$
error_description
string

人が読んで理解できる説明で、アカウントを名指しすることはありません。

HTTP 401

JSON レスポンスの本文。 application/json

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

JSON を新しいタブで開く

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

error: "SERVER_401"

認可が必要です。

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

フィールド型と説明
error

必須

string (常に: "SERVER_401")
http_code
number (常に: 401)
message
string

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

error: "TOKEN_INVALID_CREDENTIALS"

クライアント認証情報が無効です。

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

フィールド型と説明
error

必須

string (常に: "TOKEN_INVALID_CREDENTIALS")
http_code
number (常に: 401)
message
string

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

必須プロパティ: error

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

フィールド型と説明
error

必須

string

RFC 6749、7591、または 8707 のエラーコード(invalid_grant など)。

検証パターン(正規表現)^(?:access_denied|invalid_client|invalid_client_metadata|invalid_grant|invalid_redirect_uri|invalid_request|invalid_scope|invalid_target|server_error|unauthorized_client|unsupported_grant_type)$
error_description
string

人が読んで理解できる説明で、アカウントを名指しすることはありません。

HTTP 403

JSON レスポンスの本文。 application/json

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

JSON を新しいタブで開く

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

error: "TOKEN_INVALID_AUDIENCE"

オーディエンスが無効です。

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

フィールド型と説明
error

必須

string (常に: "TOKEN_INVALID_AUDIENCE")
http_code
number (常に: 403)
message
string

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

error: "TOKEN_INVALID_SCOPE"

スコープが無効であるか、許可されていません。

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

フィールド型と説明
error

必須

string (常に: "TOKEN_INVALID_SCOPE")
http_code
number (常に: 403)
message
string

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

HTTP 429

JSON レスポンスの本文。 application/json

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

JSON を新しいタブで開く

リクエスト数の上限に達しました。

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

フィールド型と説明
error

必須

string (常に: "RATE_LIMIT_REACHED")
http_code
number (常に: 429)
message
string

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

HTTP 500

JSON レスポンスの本文。 application/json

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

JSON を新しいタブで開く

予期しないエラーが発生しました。

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

フィールド型と説明
error

必須

string (常に: "SERVER_500")
http_code
number (常に: 500)
message
string

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

前のページ ← 再開可能なアップロード次のページ 新しい Auth Key を作成する →
サポートに問い合わせる
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)日本語