ファイルをアップロード
対象アプリ:Chatflow、Workflow、チャットボット、Agent、テキストジェネレーター。
ファイルをアップロードし、後続のリクエストから参照するための id を返します。
アプリが実際に扱えるファイル種別は、アプリのファイルアップロード設定によって決まります。アプリケーションのパラメータ情報を取得 で確認できます。
承認
すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。
キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーがない、または無効な場合は HTTP 401(unauthorized)が返ります。
ボディ
アップロードするファイル。multipart/form-data の 1 パートとして送信します。ファイル名に / や \ は使えません。
デプロイのセキュリティブラックリスト(UPLOAD_FILE_EXTENSION_BLACKLIST、デフォルトは空)にある拡張子を除き、任意の拡張子を受け付けます。
サイズ上限のデフォルト値はカテゴリごとに、画像 5 MB、音声 50 MB、動画 100 MB、その他のファイル 15 MB です。Docker Compose でデプロイした場合、画像の上限は 10 MB です。これらの上限は、プラットフォームの管理者が UPLOAD_*_FILE_SIZE_LIMIT 環境変数 で変更できます。
エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。同じワークスペース内の実行なら、送信する user にかかわらず、id でこのファイルを参照できます。エンドユーザーの識別 を参照してください。
レスポンス
ファイルが正常にアップロードされました。
アップロードしたエンドユーザーの ID。エンドユーザー取得 で詳細を確認できます。