Skip to main content
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 パートとして送信します。ファイル名に /\ は使えません。

任意の拡張子を受け付けます。

サイズ上限はカテゴリごとに適用されます:画像 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。