メインコンテンツへスキップ
POST
cURL

承認

Authorization
string
header
必須

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

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

ボディ

multipart/form-data

ファイルアップロードリクエスト。multipart/form-data 形式が必要です。

file
file
必須

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

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

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

user
string

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

レスポンス

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

id
string<uuid>

一意のファイル ID。

name
string

ファイル名。

size
integer

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

extension
string | null

ファイル拡張子。

mime_type
string | null

ファイルの MIME タイプ。

created_by
string<uuid> | null

アップロードしたエンドユーザーの ID。エンドユーザー取得 で詳細を確認できます。

created_at
integer<int64>

アップロードタイムスタンプ(Unix エポック秒)。

preview_url
string | null

ファイルのプレビュー URL。

source_url
string

ファイルの署名付きダウンロード URL です。

original_url
string | null

ファイルの元の URL。

user_id
string<uuid> | null

未使用です。常に null になります。

tenant_id
string<uuid> | null

関連付けられたテナントの ID。

conversation_id
string<uuid> | null

関連付けられた会話の ID。

file_key
string | null

未使用です。常に null になります。