> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ファイルをダウンロード

> 以前[ファイルをアップロード](/api-reference/ファイル操作/ファイルをアップロード) API 経由でアップロードされたファイルをプレビューまたはダウンロードします。ファイルは、リクエスト元のアプリケーション内のメッセージに属する場合のみアクセスできます。



## OpenAPI

````yaml /ja/api-reference/openapi_completion.json get /files/{file_id}/preview
openapi: 3.0.1
info:
  title: Completion アプリ API
  description: テキスト生成アプリケーションはセッションなしで動作し、翻訳、記事作成、要約 AI などに最適です。
  version: 1.0.0
servers:
  - url: https://{api_base_url}
    description: テキスト生成アプリ API のベース URL です。セルフホスト環境では、独自の API ベース URL に置き換えてください。
    variables:
      api_base_url:
        default: api.dify.ai/v1
        description: API ベース URL のホストとパス（`https://` を除く）。
security:
  - ApiKeyAuth: []
tags:
  - name: 完了メッセージ
    description: テキスト生成に関連する操作です。
  - name: ファイル操作
    description: ファイル管理に関連する操作です。
  - name: エンドユーザー
    description: エンドユーザー情報に関連する操作です。
  - name: メッセージフィードバック
    description: ユーザーフィードバックに関連する操作です。
  - name: 音声・テキスト変換
    description: テキスト読み上げと音声認識に関連する操作です。
  - name: アプリケーション設定
    description: アプリケーション設定と情報を取得する操作です。
paths:
  /files/{file_id}/preview:
    get:
      tags:
        - ファイル操作
      summary: ファイルをダウンロード
      description: >-
        以前[ファイルをアップロード](/api-reference/ファイル操作/ファイルをアップロード) API
        経由でアップロードされたファイルをプレビューまたはダウンロードします。ファイルは、リクエスト元のアプリケーション内のメッセージに属する場合のみアクセスできます。
      operationId: previewCompletionFileJa
      parameters:
        - name: file_id
          in: path
          required: true
          description: >-
            プレビューするファイルの一意の識別子です。[ファイルをアップロード](/api-reference/ファイル操作/ファイルをアップロード)
            API のレスポンスから取得します。
          schema:
            type: string
            format: uuid
        - name: as_attachment
          in: query
          required: false
          description: '`true` の場合、ブラウザでプレビューする代わりにファイルを添付ファイルとして強制ダウンロードします。'
          schema:
            type: boolean
            default: false
        - name: user
          in: query
          required: false
          description: ユーザー識別子。エンドユーザーのコンテキストに使用されます。
          schema:
            type: string
      responses:
        '200':
          description: >-
            生のファイルコンテンツを返します。`Content-Type` ヘッダーはファイルの MIME
            タイプに設定されます。`as_attachment` が `true` の場合、ファイルは `Content-Disposition:
            attachment` としてダウンロード形式で返されます。
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
        '403':
          description: '`file_access_denied` : リクエストされたファイルへのアクセスが拒否されました。'
          content:
            application/json:
              examples:
                file_access_denied:
                  summary: file_access_denied
                  value:
                    status: 403
                    code: file_access_denied
                    message: Access to the requested file is denied.
        '404':
          description: '`file_not_found` : リクエストされたファイルが見つかりません。'
          content:
            application/json:
              examples:
                file_not_found:
                  summary: file_not_found
                  value:
                    status: 404
                    code: file_not_found
                    message: The requested file was not found.
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY
      description: >-
        API Key 認証です。すべての API リクエストにおいて、`Authorization` HTTP ヘッダーに `Bearer `
        プレフィックスを付けた API Key を含めてください。例：`Authorization: Bearer {API_KEY}`。**API
        Key はサーバーサイドに保存し、クライアントサイドで共有・保存しないことを強く推奨します。API Key
        の漏洩は深刻な結果につながる可能性があります。**

````