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