メインコンテンツへスキップ
POST
パイプラインファイルをアップロード

承認

Authorization
string
header
必須

すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーがない、または無効な場合は HTTP 401(unauthorized)が返ります。

ボディ

multipart/form-data
file
file
必須

アップロードするファイル。multipart/form-data の 1 パートとして送信します。ファイル名に / や \ は使えません。

デプロイのセキュリティブラックリスト(UPLOAD_FILE_EXTENSION_BLACKLIST、デフォルトは空)にある拡張子を除き、任意の拡張子を受け付けます。

サイズ上限のデフォルト値はカテゴリごとに、画像 5 MB、音声 50 MB、動画 100 MB、その他のファイル 15 MB です。Docker Compose でデプロイした場合、画像の上限は 10 MB です。これらの上限は、プラットフォームの管理者が UPLOAD_*_FILE_SIZE_LIMIT 環境変数 で変更できます。

レスポンス

ファイルが正常にアップロードされました。

id
string

アップロードされたファイルの一意識別子。

name
string

元のファイル名。

size
integer

ファイルサイズ(バイト)。

extension
string

ファイル拡張子。

mime_type
string

ファイルの MIME タイプ。

created_by
string

ファイルをアップロードしたユーザーの ID。

created_at
string

アップロードのタイムスタンプ(ISO 8601 形式)。