ファイルをアップロード
対象アプリ:Chatflow、Workflow、チャットボット、Agent、テキストジェネレーター。
ファイルをアップロードし、後続のリクエストから参照するための id を返します。ファイルはアップロードしたエンドユーザーに属し、同じ user を持つリクエストだけがそのファイルを参照できます。
アプリが実際に扱えるファイル種別は、アプリのファイルアップロード設定によって決まります。アプリケーションのパラメータ情報を取得 で確認できます。
承認
すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。
キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401(unauthorized)で失敗します。
ボディ
ファイルアップロードリクエスト。multipart/form-data 形式が必要です。
このアップロードが属するエンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。省略すると、共有の DEFAULT-USER に帰属します。同じ user を持つ後続のリクエストだけがこのファイルを参照できます。エンドユーザーの識別 を参照してください。
レスポンス
ファイルが正常にアップロードされました。
一意のファイル ID。
Agent やツールのコンテキストでファイルを添付する際に内部的に使用される不透明なファイル参照です。このエンドポイントでアップロードされたファイルでは常に null です。
ファイル名。
ファイルサイズ(バイト)。
ファイル拡張子。
ファイルの MIME タイプ。
アップロードタイムスタンプ(Unix エポック秒)。
ファイルのプレビュー URL。
ファイルの署名付きダウンロード URL です。
ファイルの元の URL。
未使用です。常に null になります。
関連付けられたテナントの ID。
関連付けられた会話の ID。
未使用です。常に null になります。