> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ファイルを表示

> ComfyUIファイルシステムからファイルを取得して表示します。このエンドポイントは通常、生成済み画像やその他の出力ファイルを表示するために使用されます。




## OpenAPI

````yaml /openapi/cloud.ja.yaml get /api/view
openapi: 3.0.3
info:
  title: Comfy Cloud API
  description: >
    <Warning>

    **実験的API:** このAPIは実験的であり、変更される可能性があります。

    エンドポイント、リクエスト/レスポンス形式、および動作は予告なく変更される場合があります。

    </Warning>


    Comfy CloudのAPI - クラウドインフラ上でComfyUIワークフローを実行します。


    このAPIを使用すると、Comfy Cloudとプログラムで連携できます。内容は次のとおりです。

    - ワークフローの送信と管理

    - ファイルのアップロードとダウンロード

    - ジョブの状態と進捗の監視


    ## クラウド vs OSS ComfyUI 互換性


    Comfy Cloudは最大限の互換性のためにOSS
    ComfyUIと同じAPIインターフェースを実装していますが、一部のフィールドは互換性のために受け入れられますが、異なる処理が行われたり無視されたりします。


    | フィールド | エンドポイント | クラウドの動作 |

    |-------|-----------|----------------|

    | `subfolder` | `/api/view`, `/api/upload/*` | **無視** -
    クラウドはコンテンツアドレスストレージ（ハッシュベース）を使用します。クライアント側の整理のためにレスポンスで返されます。 |

    | `type` (input/output/temp) | `/api/view`, `/api/upload/*` | 部分的に使用 -
    すべてのファイルはディレクトリ構造ではなくタグベースの整理で保存されます。 |

    | `overwrite` | `/api/upload/*` | **無視** -
    コンテンツアドレスストレージでは、同一のコンテンツは常に同じハッシュを持ちます。 |

    | `number`, `front` | `/api/prompt` | **無視** - クラウドはユーザーごとに独自の公平キュー
    スケジューリングを使用します。 |

    | `split`, `full_info` | `/api/userdata` | **無視** -
    クラウドは常に完全なファイルメタデータを返します。 |


    これらのフィールドは、既存のComfyUIクライアントやワークフローとのドロップイン互換性のためにAPIスキーマに保持されています。
  version: 1.0.0
  license:
    name: GNU General Public License v3.0
    url: https://github.com/Comfy-Org/ComfyUI/blob/master/LICENSE
servers:
  - url: https://cloud.comfy.org
    description: Comfy Cloud API
security:
  - ApiKeyAuth: []
tags:
  - name: workflow
    description: |
      ワークフローを実行のために送信し、実行キューを管理します。
      これはクラウド上でComfyUIワークフローを実行するための主要な方法です。
  - name: job
    description: |
      ジョブステータスを監視し、実行履歴を表示し、実行中のジョブを管理します。
      ジョブはPOST /api/promptを介してワークフローを送信するときに作成されます。
  - name: asset
    description: |
      永続的なアセット（画像、モデル、出力）をアップロード、ダウンロード、管理します。
      アセットはタグ付けとメタデータサポートを備えた耐久性のあるストレージを提供します。
  - name: file
    description: |
      ローカルのComfyUIと互換性のあるレガシーファイルのアップロードおよびダウンロードエンドポイント。
      新しい統合には、代わりにAssets APIの使用を検討してください。
  - name: model
    description: |
      利用可能なAIモデルをブラウズします。モデルはクラウドインフラストラクチャにプリロードされています。
  - name: node
    description: |
      利用可能なComfyUIノードとその入力/出力に関する情報を取得します。
      動的なワークフローインターフェースの構築に役立ちます。
  - name: user
    description: |
      ユーザーアカウント情報と個人データの保存。
  - name: system
    description: |
      サーバーステータス、ヘルスチェック、システム情報。
paths:
  /api/view:
    get:
      tags:
        - file
      summary: ファイルを表示
      description: >
        ComfyUIファイルシステムからファイルを取得して表示します。このエンドポイントは通常、生成済み画像やその他の出力ファイルを表示するために使用されます。
      operationId: viewFile
      parameters:
        - name: filename
          in: query
          required: true
          description: 表示するファイルの名前
          schema:
            type: string
            example: ComfyUI_00004_.png
        - name: subfolder
          in: query
          required: false
          description: >
            ファイルが配置されているサブフォルダパス。

            **注記:** ComfyUI
            API互換性のために受け入れられますが、クラウドでは**無視**されます。クラウドはコンテンツアドレスストレージを使用し、アセットはハッシュのみで保存されます。サブフォルダはクライアントサイドのUIメタデータであり、ストレージのルックアップには使用されません。
          schema:
            type: string
            example: tests/foo/bar
        - name: type
          in: query
          required: false
          description: >
            ファイルのタイプ（例：出力、入力、一時）。

            **注記:** クラウドでは、`output` ファイルと `temp`
            ファイルの両方が同じバケットに保存されます。typeパラメータは互換性のために使用されますが、ストレージの場所はハッシュによって決定されます。
          schema:
            type: string
            example: output
        - name: fullpath
          in: query
          required: false
          description: ファイルの完全なパス（一時ファイルに使用）
          schema:
            type: string
        - name: format
          in: query
          required: false
          description: ファイルのフォーマット
          schema:
            type: string
        - name: frame_rate
          in: query
          required: false
          description: ビデオファイルのフレームレート
          schema:
            type: integer
        - name: workflow
          in: query
          required: false
          description: ワークフロー識別子
          schema:
            type: string
        - name: timestamp
          in: query
          required: false
          description: タイムスタンプパラメータ
          schema:
            type: integer
            example: '1234567890'
        - name: channel
          in: query
          required: false
          description: |
            PNG画像から抽出する画像チャンネル。
            - 'rgb': RGBチャンネルのみを返します（アルファは完全不透明に設定）
            - 'a' または 'alpha': アルファチャンネルをグレースケール画像として返します
            - 指定しない場合は、リダイレクト経由でオリジナル画像をそのまま返します
          schema:
            type: string
            example: rgb
      responses:
        '200':
          description: '成功: ファイルコンテンツが返されます（チャンネルパラメータが存在する場合に使用）'
          content:
            image/png:
              schema:
                type: string
                format: binary
                description: 抽出されたチャンネルを持つ処理済みPNG画像
        '302':
          description: GCS署名付きURLへのリダイレクト
          headers:
            Location:
              description: GCS内のファイルにアクセスするための署名付きURL
              schema:
                type: string
        '400':
          description: 無効なリクエストパラメータ
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: ファイルが見つからないか、権限がありません
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: 内部サーバーエラー
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |
        APIキー認証。アカウント設定からAPIキーを生成します
        （https://platform.comfy.org/profile/api-keys）。X-API-Keyヘッダーでキーを渡します。

````