> ## 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.

# ジョブの完全な詳細を取得

> 特定のジョブの完全な詳細（ワークフローと出力を含む）を取得します。
詳細ビュー、ワークフローの再実行、デバッグに使用します。




## OpenAPI

````yaml /openapi/cloud.ja.yaml get /api/jobs/{job_id}
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/jobs/{job_id}:
    get:
      tags:
        - job
      summary: ジョブの完全な詳細を取得
      description: |
        特定のジョブの完全な詳細（ワークフローと出力を含む）を取得します。
        詳細ビュー、ワークフローの再実行、デバッグに使用します。
      operationId: getJobDetail
      parameters:
        - name: job_id
          in: path
          required: true
          description: ジョブ識別子 (UUID)
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: 成功 - ジョブ詳細を取得しました
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetailResponse'
        '401':
          description: 認証エラー - 認証が必要です
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          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:
    JobDetailResponse:
      type: object
      description: ワークフローと出力を含む完全なジョブ詳細
      required:
        - id
        - status
        - create_time
        - update_time
      properties:
        id:
          type: string
          format: uuid
          description: 一意のジョブ識別子
        status:
          type: string
          enum:
            - pending
            - in_progress
            - completed
            - failed
            - cancelled
          description: ユーザーフレンドリーなジョブステータス
        workflow:
          type: object
          description: 完全なComfyUIワークフロー（10〜100KB、利用不可の場合は省略）
          additionalProperties: true
        execution_error:
          $ref: '#/components/schemas/ExecutionError'
          description: ComfyUIからの詳細な実行エラー（構造化エラーデータがある失敗ジョブのみ）
        create_time:
          type: integer
          format: int64
          description: ジョブ作成タイムスタンプ（秒単位のUnixタイムスタンプ）
        update_time:
          type: integer
          format: int64
          description: 最終更新タイムスタンプ（秒単位のUnixタイムスタンプ）
        outputs:
          type: object
          description: ComfyUIからの完全な出力オブジェクト（ターミナル状態のみ）
          additionalProperties: true
        preview_output:
          type: object
          description: プライマリ出力のプレビュー（ターミナル状態のみ）
          additionalProperties: true
        outputs_count:
          type: integer
          description: 出力ファイルの総数（非ターミナル状態では省略）
        workflow_id:
          type: string
          description: ワークフローグラフ定義を識別するUUID
        execution_status:
          type: object
          description: ComfyUI実行ステータスとタイムライン（ターミナル状態のみ）
          additionalProperties: true
        execution_meta:
          type: object
          description: ノードレベルの実行メタデータ（ターミナル状態のみ）
          additionalProperties: true
    ErrorResponse:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
    ExecutionError:
      type: object
      description: ComfyUIからの詳細な実行エラー情報
      required:
        - node_id
        - node_type
        - exception_message
        - exception_type
        - traceback
        - current_inputs
        - current_outputs
      properties:
        node_id:
          type: string
          description: 失敗したノードのID
        node_type:
          type: string
          description: 'ノードのタイプ名（例: "KSampler"）'
        exception_message:
          type: string
          description: 人間が読めるエラーメッセージ
        exception_type:
          type: string
          description: 'Pythonの例外タイプ（例: "RuntimeError"）'
        traceback:
          type: array
          items:
            type: string
          description: トレースバック行の配列（利用不可の場合は空の配列）
        current_inputs:
          type: object
          additionalProperties: true
          description: 障害発生時の入力値（利用不可の場合は空のオブジェクト）
        current_outputs:
          type: object
          additionalProperties: true
          description: 失敗時の出力値（利用不可の場合は空オブジェクト）
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |
        APIキー認証。アカウント設定からAPIキーを生成します
        （https://platform.comfy.org/profile/api-keys）。X-API-Keyヘッダーでキーを渡します。

````