Skip to main content
post/files/upload
Request example
Response
post/files/upload

Authorization

Authorizationstringheaderrequired#

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

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401(unauthorized)で失敗します。

Body

multipart/form-data
filefilerequired#

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

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

サイズ上限はカテゴリごとに適用されます:画像 10 MB、音声 50 MB、動画 100 MB、その他のファイル 15 MB(デフォルト値。Dify Cloud はデフォルト値を使用)。セルフホスト環境では UPLOAD_*_FILE_SIZE_LIMIT 環境変数 で調整できます。

userstring#
このアップロードが属するエンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。省略すると、共有の DEFAULT-USER に帰属します。同じ user を持つ後続のリクエストだけがこのファイルを参照できます。エンドユーザーの識別 を参照してください。

Responses

application/json
ファイルが正常にアップロードされました。
conversation_idstring#
関連付けられた会話の ID。
created_atinteger#
アップロードタイムスタンプ(Unix エポック秒)。
created_bystring#
アップロードしたエンドユーザーの ID。エンドユーザー取得 で詳細を確認できます。
extensionstring#
ファイル拡張子。
file_keystring#
未使用です。常に null になります。
idstring#
一意のファイル ID。
mime_typestring#
ファイルの MIME タイプ。
namestring#
ファイル名。
original_urlstring#
ファイルの元の URL。
preview_urlstring#
ファイルのプレビュー URL。
referencestring#
Agent やツールのコンテキストでファイルを添付する際に内部的に使用される不透明なファイル参照です。このエンドポイントでアップロードされたファイルでは常に null です。
sizeinteger#
ファイルサイズ(バイト)。
source_urlstring#
ファイルの署名付きダウンロード URL です。
tenant_idstring#
関連付けられたテナントの ID。
user_idstring#
未使用です。常に null になります。