API Reference

Job 목록 조회

인증한 사용자가 이 API에 Comfy prompt를 전달해 생성한 Job을 최신순으로 조회합니다.

GET/v1/api/job/list

요청 예제

bash

curl --request GET   --url "$NORDY_BASE_URL/v1/api/job/list?limit=20"   --header "api-key: $NORDY_API_KEY"

성공 응답200 OK

JSON

{
  "jobs": [
    {
      "id": "68abcdef0123456789abcdef",
      "user_metadata": {},
      "status": "queued",
      "createdAt": "2026-08-26T00:00:00.000Z",
      "startedAt": null,
      "completedAt": null,
      "outputs": null,
      "error": null
    }
  ],
  "next_cursor": "example-next-cursor"
}

인증

api-keystring필수

사용자 API key를 api-key request header에 넣습니다.

파라미터

limitintegerquery선택: 1~20 사이의 페이지 크기이며 기본값은 20입니다.
cursorstringquery선택: 이전 응답의 next_cursor를 수정 없이 입력하세요. 예제의 커서가 아닌 실제 응답 값을 사용합니다.

성공 응답

200 OK

jobsarrayresponse필수: 이번 페이지의 Job 목록입니다.
jobs[].idstringresponse필수: Job ID입니다.
jobs[].user_metadataobjectresponse필수: Job 생성 시 전달한 metadata이며 생략하면 {}입니다.
jobs[].statusqueued | processing | succeeded | failed | canceledresponse필수: 현재 Job 상태입니다.
jobs[].createdAtdate-timeresponse필수: Job 생성 시각입니다.
jobs[].startedAtdate-timeresponse필수nullable: 실행 시작 시각이며 값이 없으면 null입니다.
jobs[].completedAtdate-timeresponse필수nullable: 최종 완료 시각이며 값이 없으면 null입니다.
jobs[].outputsarrayresponse필수nullable: succeeded Job의 미만료 결과입니다. 모두 만료되면 []이며 Job은 계속 조회할 수 있습니다. 그 외 상태는 null입니다.
jobs[].outputs[].idstringresponse필수: API Output Asset ID입니다.
jobs[].outputs[].urlstringresponse필수: 생성된 파일 URL입니다.
jobs[].outputs[].kindimage | video | audio | model3dresponse필수: Output media kind입니다.
jobs[].outputs[].expiresAtdate-timeresponse필수: 이 결과가 생성된 시점으로부터 7일 후의 만료 시각입니다. 그 전에 파일을 다운로드하세요.
jobs[].errorobjectresponse필수nullable: failed·canceled Job의 최종 오류이며 그 외에는 null입니다.
jobs[].error.codeenumresponse필수: INVALID_INPUT, INSUFFICIENT_CREDIT, EXECUTION_TIMEOUT, WORKER_UNAVAILABLE, EXECUTION_FAILED, JOB_CANCELED 중 하나입니다.
jobs[].error.messagestringresponse필수: 공개 오류 메시지입니다.
jobs[].error.detailsobjectresponse선택: ComfyUI 원본 validation 데이터입니다. 가능한 경우 INVALID_INPUT에만 포함됩니다.
jobs[].error.details.errorobjectresponse필수: ComfyUI prompt의 유효성 검사 오류입니다.
jobs[].error.details.node_errorsobjectresponse필수: Node ID별 ComfyUI 유효성 검사 오류입니다.
next_cursorstringresponse필수nullable: 다음 페이지 커서이며 마지막 페이지에서는 null입니다.

응답과 오류

Status	Code	설명
400	INVALID_INPUT	limit 또는 cursor가 유효하지 않습니다.
400	MULTIPLE_AUTH_CREDENTIALS	로그인 쿠키를 제외하고 api-key header만 보내세요.
401	AUTHENTICATION_REQUIRED	API key가 없거나 일치하지 않습니다.
403	USER_SUSPENDED, PRO_SUBSCRIPTION_REQUIRED, INVALID_INPUT	계정이 정지되었거나, Pro 구독이 활성화되어 있지 않거나, API 이용이 제한된 상태입니다.
500	INTERNAL_ERROR	서버 내부 오류입니다.