跳转到主要内容
GET
/
api
/
jobs
/
{job_id}
Get full job details
curl --request GET \
  --url https://cloud.comfy.org/api/jobs/{job_id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "create_time": 123,
  "update_time": 123,
  "workflow": {},
  "execution_error": {
    "node_id": "<string>",
    "node_type": "<string>",
    "exception_message": "<string>",
    "exception_type": "<string>",
    "traceback": [
      "<string>"
    ],
    "current_inputs": {},
    "current_outputs": {}
  },
  "outputs": {},
  "preview_output": {},
  "outputs_count": 123,
  "workflow_id": "<string>",
  "execution_status": {},
  "execution_meta": {}
}

授权

X-API-Key
string
header
必填

API key authentication. Generate an API key from your account settings at https://comfy.org/account. Pass the key in the X-API-Key header.

路径参数

job_id
string<uuid>
必填

Job identifier (UUID)

响应

Success - Job details retrieved

Full job details including workflow and outputs

id
string<uuid>
必填

Unique job identifier

status
enum<string>
必填

User-friendly job status

可用选项:
pending,
in_progress,
completed,
failed,
cancelled
create_time
integer<int64>
必填

Job creation timestamp (Unix timestamp in seconds)

update_time
integer<int64>
必填

Last update timestamp (Unix timestamp in seconds)

workflow
object

Full ComfyUI workflow (10-100KB, omitted if not available)

execution_error
object

Detailed execution error from ComfyUI (only for failed jobs with structured error data)

outputs
object

Full outputs object from ComfyUI (only for terminal states)

preview_output
object

Primary preview output (only for terminal states)

outputs_count
integer

Total number of output files (omitted for non-terminal states)

workflow_id
string

UUID identifying the workflow graph definition

execution_status
object

ComfyUI execution status and timeline (only for terminal states)

execution_meta
object

Node-level execution metadata (only for terminal states)