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形式ベストプラクティス
はじめに
  • 概要
  • はじめてのアプリ
  • 処理結果ファイルの保存
トピック
  • Assembly Instructions
  • Assembly Variable
  • 動的評価
  • Template
  • Webhook
  • サードパーティ認証情報
  • Builtin Template
  • リサイズ方式
  • Assembly Execution Progress
  • Workspace
  • AI エージェント
  • use パラメーターの高度な設定
  • ignore_errors パラメーター
ソフトウェア開発キット
  • 概要
  • Android SDK
  • ブラウザー
  • Convex
  • cURL
  • Go SDK
  • Java SDK
  • MCP Server
  • マルチパートフォーム
  • Node.js SDK
  • Next.js 向け Viewer
  • PHP SDK
  • Python SDK
  • Ruby SDK
  • Terraform
  • TransloaditKit
  • Zapier 連携
移行
  • 移行ガイド
  • Cloudinary から Transloadit への移行
  • Uploadcare から Transloadit への移行
  • Mux から Transloadit への移行
  • Filestack から Transloadit への移行

AI エージェント

Claude Code、OpenAI Codex、Cursor などの AI コーディングエージェントは、Transloadit に接続し、現行の 96 個の Robot でファイルをアップロード、エンコード、変換できます。実行時のツールアクセスには MCP サーバー、人が指示するワークフローには再利用可能な Agent Skills、ドキュメントのコンテキストには llms.txt を組み合わせて利用できます。CLI は、人や CI 向けに別の自動化手段を提供します。

プロジェクトから開始

プロジェクトのルートで、次のプロンプトをコーディングエージェントに貼り付けてください。SDK、MCP、スキルを選ぶ前に技術スタックを調査させ、最初の変更をレビューしやすい規模に抑えます。

Set up the smallest safe Transloadit integration for this repository.

1. Inspect the project’s language, runtime, package manager, existing upload/media code, tests, and agent configuration before changing files.
2. Choose the narrowest integration that fits: an official SDK for application code, MCP for agent-executed runtime tools, the CLI (npx -y @transloadit/node) for scripts and CI jobs, and Agent Skills for repeatable workflow guidance. Reuse an existing integration when present.
3. Before editing, summarize what you found, which path you chose, and the files and commands you expect to change. Use the project’s existing package manager.
4. For interactive hosted MCP, add the hosted URL https://api2.transloadit.com/mcp to the client configuration without any token or key, and have the user approve browser OAuth. For CI or headless hosted MCP, mint an mcp-audience Bearer token at run time in a trusted environment, mint a new one when it expires, and supply it through secret storage or an environment variable.
5. Use TRANSLOADIT_KEY and TRANSLOADIT_SECRET only in a trusted server, CLI, CI, or self-hosted MCP process. When signing with an Auth Key, match its signature algorithm: for the Node CLI or self-hosted MCP, set TRANSLOADIT_SIGNATURE_ALGORITHM; in Node SDK code, pass the signatureAlgorithm option. Console keys with Smart CDN signing on (the default) use sha256; the Console’s snippet for the key shows the value.
6. Never expose TRANSLOADIT_SECRET to browser, mobile, or other client code. Give client code a public Auth Key and a Template ID; for production, generate the params and signature on a trusted backend with Signature Authentication. Use unsigned client params only with test credentials.
7. Never hardcode, print, commit, or overwrite credentials, including minted Bearer tokens. Keep secrets out of committed MCP configuration. If required credentials are unavailable, scaffold placeholders and stop before account operations.
8. Create one minimal, typed workflow and validate its Assembly Instructions. Prefer an existing small media fixture. Without an account, validate inline instructions locally with npx -y @transloadit/node assemblies lint --steps <file>. Linting against a Template ID needs credentials. Do not create an account, change a plan, or modify production Templates.
9. Run the repository’s checks. If authenticated Transloadit access (an approved hosted MCP connection or credentials in a trusted process) and a suitable fixture are available and the user has authorized a live test, run one Assembly, wait for completion, and report its Assembly ID, status, and result URL. Otherwise, report the exact command or MCP tool call the maintainer can run. Credentials or an approved connection alone do not authorize a live run.
10. Summarize every changed file, verification result, and any remaining manual step.

想定する成果物は、単なるコードサンプルではなく、リポジトリへの小規模な変更です。実際の Assembly の実行を許可する前に、エージェントが提案する認証情報の取り扱い範囲を確認してください。

エージェントが選ぶべき手段

プロジェクトの特徴や要件最初に使う手段
Node.js、Python、Ruby、PHP、Go、Java、Android、iOS のアプリケーション対応する公式 SDK
処理設定のリント、ドキュメントの調査、Assembly の実行が必要なエージェントMCP サーバー
ビルドスクリプト、CI ジョブ、シェルパイプライン、アカウント不要のリントCLI
再利用可能でバージョン管理されたワークフローを求めるチームAgent Skills
実行時の連携はまだ不要llms.txt と Markdown のドキュメントページ

MCP サーバー

Model Context Protocol⁠(MCP)により、エージェントは実行時に Transloadit のツールへ直接アクセスできます。

デモ:Claude で Transloadit MCP Server を使い、動画を HLS アダプティブストリーミング向けにエンコード

接続方法は 3 通りあります。クライアントに合う最初の方法を選んでください。

クライアント接続方法認証情報
Claude、ChatGPT、Codex、Cursor などの対話型エージェントクライアントホスト型 URLブラウザーで OAuth を承認
CI ジョブやヘッドレスのエージェント実行環境Bearer トークンを使うホスト型 URLAuth Key から発行したトークン
サーバー自体を実行させるエージェントセルフホストの stdioドキュメントとリントには不要、Assembly には Auth Key が必要

URL で接続

ホスト型 MCP の URL を MCP クライアントに追加してください。

https://api2.transloadit.com/mcp

ブラウザーで OAuth アクセスを承認し、クライアントに使用を許可する Workspace を選択してください。ローカルサーバーのインストールや、Auth Key、Auth Secret のコピーは不要です。承認すると、表示された権限だけを持つアプリ専用の Auth Key が作成されます。アクセスは接続済みアプリで取り消せます。

補足

ホスト型サーバーでは、Robot のドキュメントやリントを含め、どのツールを実行する前にもサインインが必要です。これらをアカウントなしで使うには、サーバーをセルフホストで実行してください。

CI とヘッドレスクライアント

ブラウザーでアクセスを承認する人がいない環境では、audience が mcp のトークンを、ホスト型エンドポイントへ Authorization: Bearer <token> として送信してください。Auth Key と Auth Secret を保持する信頼できる環境で発行します(CLI では TRANSLOADIT_KEY と TRANSLOADIT_SECRET)。

npx -y @transloadit/node auth token --aud mcp

このコマンドは JSON を出力します。access_token の値だけを取得し、シークレットストレージや環境変数を通じてエージェントの実行環境に渡してください。レスポンスをログやエージェントの会話履歴に出力しないでください。

  • 有効期限:トークンは、返された expires_in の期間が経過すると失効します(MCP のデフォルトは 1 週間)。ジョブやセッションごとに発行し、作業がその期間を超える場合は新たに発行してください。
  • スコープ:--scope でアクセス範囲を絞ってください。指定しない場合、Auth Key のスコープを継承します。
  • 失効:有効期限前にアクセスを遮断するには、トークンの発行元の Auth Key を削除してください。CI 専用の Auth Key を使用してください。

クライアントの設定例は、CI とヘッドレスクライアントを参照してください。

セルフホストの stdio

MCP クライアントでサーバーを stdio コマンドとして設定してください。ほとんどのクライアントでは自動的に起動されます。Robot のドキュメントとリントはアカウントなしで利用できます。

npx -y @transloadit/mcp-server stdio

Assembly の作成などのアカウント操作には、サーバープロセスの環境変数で TRANSLOADIT_KEY と TRANSLOADIT_SECRET を渡し、TRANSLOADIT_SIGNATURE_ALGORITHM を Auth Key に合わせて設定してください。Console で Smart CDN 署名を有効(デフォルト)にして作成したキーは sha256 を使用しますが、サーバーのデフォルトは sha384 です。Console のキー用スニペットで設定値を確認できます。署名アルゴリズムの設定を参照してください。

stdio プロセスはエージェントのマシン上で認証情報を保持します。必要なスコープだけを持つ専用の Auth Key を使い、コミットする MCP 設定ファイルに認証情報を含めないでください。

クライアントの設定例(Claude、Cursor、VS Code/Copilot)、認証の詳細、ツールのドキュメント、制限、ホスト型とセルフホストの動作の違いは、MCP サーバーのドキュメントを参照してください。

自動化の手段

Transloadit のエージェント向けツール群は、実行ツールとワークフローの指針、ドキュメントのコンテキストを組み合わせます。CLI と MCP はワークフローを実行し、Agent Skills と llms.txt はエージェントによるツールの活用を支援します。

  • CLI:人や CI ジョブが、Assembly の作成、完了待機、結果取得を繰り返し実行できるコマンドを必要とする場合は、@transloadit/node を使ってください。
  • MCP:組み込み型やホスト型のエージェントに Transloadit のツールを公開します。エージェントは Robot のドキュメントを調べ、Assembly Instructions をリントし、Assembly を作成してステータスの更新を追跡できます。transloadit_create_assembly に直接渡すファイルには、公開 URL、小さなインラインファイル、またはクライアントが引き渡す添付ファイルを使ってください。返されたアップロードコマンドでローカルやサンドボックスのファイルをアップロードするには、シェルが必要です。対応する入力を参照してください。
  • Agent Skills:ターミナルアクセス、MCP、CLI、SDK などの有用なツールをすでに持つエージェント向けに、チーム固有のメディアワークフローの手順書をバージョン管理します。スキルは使用する Template、検証手順、フォールバックをエージェントに伝えますが、それ自体で新しい機能を付与するものではありません。
  • llms.txt:Assembly を提案する前に、Transloadit の製品、ソリューション、連携機能、開発者向けリソース、学習コンテンツの最新の全体像を、あらゆる LLM に提供します。

人が対話型エージェントクライアントを接続する場合は、ブラウザーの OAuth でホスト型 MCP を使用してください。無人の自動化では、認証情報を信頼できる環境に保持してください。audience が mcp の Bearer トークンをホスト型 MCP に送信するか、Auth Key と Auth Secret をセルフホストの stdio、CLI、独自のバックエンドに渡します。

Agent Skills

Agent Skills⁠ は、タスクを段階的に進める方法をエージェントに教える Markdown ファイル(SKILL.md)です。

デモ:Claude で Transloadit Agent Skills を使い、動画を HLS アダプティブストリーミング向けにエンコード

実用上、MCP サーバーは、エージェントが実行時にローカルまたはホスト型の MCP プロセスを介して呼び出す API インターフェースです。一方、スキルは、何をどの順序で行い、どう検証するかを伝える、バージョン管理された手順書です。スキル自体が新たなツールアクセスを追加するわけではありません。環境内のツール(MCP、CLI、SDK)を一貫した方法で使わせるための方針を明文化します。

  • MCP は、組み込みの反復可能な実行(Assembly の作成、ポーリング、結果取得)に使います。
  • スキルは、セットアップ、ひな形の作成、テンプレート、移行などの作業を、人の指示で進めるための再利用可能な手順書として使います。

両者は補完関係にもあります。スキルでワークフローを標準化し、実際の実行には MCP(またはローカル CLI によるフォールバック)を使うようエージェントに指示できます。

Skills CLI でインストール

npx skills add transloadit/skills

これにより、Transloadit の全 19 件のスキルがプロジェクトにインストールされます。

  • docs-transloadit-robots

    transloadit CLI で、Transloadit の Robot とそのパラメーターのドキュメントや使用例をオフラインで参照します。Robot 名やパラメーターを推測せずに steps JSON を作成、検証する際に使用してください。

  • integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs

    Next.js App Router プロジェクトに、明示的に設定したアセット用の Transloadit Smart CDN URL 署名をサーバー側で追加します。

  • integrate-uppy-transloadit-s3-uploading-to-nextjs

    Next.js(App Router)アプリに Uppy Dashboard と Transloadit によるアップロードを追加します。サーバー側での署名生成と、任意の /s3/store エクスポートを組み込みます。

  • transform-build-mosaic-collage-with-transloadit

    公式の @transloadit/node CLI で、N 枚のローカル画像から単一画像の整列モザイク写真コラージュを単発で作成します。Robot /image/merge の mosaic エフェクトで、中央を基準に切り抜いた写真をタイル状に隙間なく整列配置します。--output で明示した出力パスに結果をダウンロードします。

  • transform-build-polaroid-collage-with-transloadit

    公式の @transloadit/node CLI で、N 枚のローカル画像から単一画像のポラロイド風の重ね置き写真コラージュを単発で作成します。Robot /image/merge の polaroid-stack エフェクトを使用し、--output で明示した出力パスに結果をダウンロードします。

  • transform-caption-video-with-transloadit

    caption-video ビルトインと公式の Transloadit CLI で、ローカル動画にシンプルな字幕を焼き込みます。字幕付き動画と SRT キューをダウンロードします。

  • transform-capture-webpage-with-transloadit

    capture-webpage ビルトインと公式の Transloadit CLI で、公開ウェブページまたはローカルの HTML を画像または PDF としてキャプチャします。

  • transform-convert-markdown-to-pdf-with-transloadit

    convert-to-pdf ビルトインと公式の Transloadit CLI で、ローカルの Office 文書、HTML、Markdown、またはテキストファイルを PDF に変換します。既存の Markdown から PDF への変換ワークフローも含みます。

  • transform-describe-image-with-transloadit

    公式の @transloadit/node CLI で、画像の説明を単発で生成します。物体を表すラベルには image describe --fields labels を、代替テキスト、タイトル、キャプション、説明を含む構造化 JSON には image describe --for wordpress を使用してください。

  • transform-encode-hls-video-with-transloadit

    transloadit CLI 経由で Transloadit を使用し、ローカル動画を HLS 配信用の各エンコード出力とプレイリストに単発でエンコードします。ビルトインの Template(builtin/encode-hls-video@latest)を優先し、-o で出力をローカルにダウンロードしてください。

  • transform-encode-video-with-transloadit

    encode-video ビルトインと公式の Transloadit CLI で、ローカル動画をウェブ再生用の MP4 または WebM にエンコードします。

  • transform-extract-text-with-transloadit

    extract-text ビルトインと公式の Transloadit CLI で、ローカルの PDF、スキャン画像、写真、Office 文書から読み取り可能なテキストまたは JSON を抽出します。

  • transform-generate-image-with-transloadit

    transloadit CLI 経由で Transloadit を使用し、プロンプトから画像ファイルを単発で生成します。テキストのみの生成にも入力データをガイドにした生成にも image generate を優先し、出力パスを固定する必要がある場合は --output を使用してください。

  • transform-make-video-covers-with-transloadit

    video-covers ビルトインと公式の Transloadit CLI で、ローカル動画からカバー画像を作成します。一定間隔のフレーム、正確なオフセット指定、またはスマート選択を使用します。

  • transform-prepare-image-with-transloadit

    prepare-image ビルトインと公式の Transloadit CLI で、ローカル画像に向きの補正、サイズ変更、圧縮、形式変換を行い、ウェブサイト用に整えます。

  • transform-remove-background-with-transloadit

    remove-background ビルトインと公式の Transloadit CLI で、ローカル写真の背景を除去し、透過 PNG をダウンロードします。

  • transform-transcribe-audio-with-transloadit

    transcribe ビルトインと公式の Transloadit CLI で、ローカルの音声または動画をテキスト、タイムスタンプ付き JSON、SRT、WebVTT に文字起こしします。

  • transform-upscale-image-with-transloadit

    transloadit CLI 経由で Transloadit を使用し、ローカル画像を AI で単発で高解像度化します。image upscale インテントを優先し、出力パスを固定するには --output を使用してください。

  • transloadit

    Transloadit の主要な入口となるスキルです。適切な integrate-*、transform-*、docs-* スキルに振り分け、決定的な動作を得るため、npx -y @transloadit/node ...(CLI)経由の実行を優先してください。

自動検出

スキルカタログは、Agent Skills Discovery RFC⁠ に従って、transloadit.com/.well-known/skills/index.json でも検出できます。そのため、次の方法でもインストールできます。

npx skills add https://transloadit.com

手動インストール

transloadit/skills⁠ リポジトリをエージェントのスキルディレクトリにクローンするか、シンボリックリンクを作成してください。

エージェントパス
Claude Code.claude/skills/
OpenAI Codex.codex/skills/
Gemini CLI.gemini/skills/
Cursor.cursor/skills/
Windsurf.codeium/windsurf/skills/

llms.txt

Transloadit は、llms.txt 標準⁠に準拠した、サイト全体のコンパクトなルーティングインデックスである llms.txt ファイルを公開しています。製品とサービス、ソリューション、連携機能、メディアとタスクのインデックス、開発者向けリソース、学習リソース、サポートを網羅しています。

Robot に特化した情報の探索には、/docs/robots/llms.txt を使ってください。従来の互換性ファイル llms-full.txt は、Robot の完全なパラメータースキーマをインラインで含むため、大きなファイルです。探索には llms.txt を優先し、リンク先の Markdown ページのうち、タスクに必要なものだけを取得してください。

どの方法を使うべきか?

方法適した用途セットアップ
OAuth を使うホスト型 MCP対話型エージェントクライアントURL を追加し、ブラウザーでアクセスを承認
Bearer トークンを使うホスト型 MCPCI とヘッドレスエージェントクライアント信頼できる環境でトークンを発行
セルフホストの MCP(stdio)サーバーのローカル実行、アカウント不要のドキュメントとリントMCP クライアントで stdio を設定し、アカウント操作にはキーを指定
公式 SDKアプリケーションコード対応する SDK をインストールし、Auth Secret はサーバーに保持
CLIスクリプト、CI ジョブ、アカウント不要のリントnpx -y @transloadit/node を実行し、アカウント操作には認証情報を指定
Agent Skills再利用可能で、人が指示する Transloadit ワークフロー1 コマンドでインストール
llms.txtあらゆる LLM への幅広い Transloadit ドキュメントのコンテキスト提供URL から取得

これらの方法は互いに補完します。対話的なツールアクセスには、ホスト型 MCP とブラウザーの OAuth から始めてください。無人のエージェントツールには、ホスト型 MCP に Bearer トークンを送信するか、セルフホストの stdio に Auth Key と Auth Secret を渡します。アプリケーションコードには公式 SDK、スクリプトや CI ジョブには CLI を使ってください。ワークフローの指針としてスキルをインストールし、ドキュメントのコンテキストとして LLM に llms.txt を参照させてください。

前のページ ← Workspace次のページ use パラメーターの高度な設定 →
サポートに問い合わせる
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)日本語