API Reference

Job 상태와 결과 조회

Job 한 건의 현재 상태, 최종 오류, 저장된 output URL을 조회합니다.

GET/v1/api/job/{id}

요청 예제

bash

curl --request GET   --url "$NORDY_BASE_URL/v1/api/job/$JOB_ID"   --header "api-key: $NORDY_API_KEY"

성공 응답200 OK

JSON

{
  "id": "68abcdef0123456789abcdef",
  "user_metadata": {},
  "status": "succeeded",
  "createdAt": "2026-08-26T00:00:00.000Z",
  "startedAt": "2026-08-26T00:00:02.000Z",
  "completedAt": "2026-08-26T00:00:10.000Z",
  "outputs": [
    {
      "id": "68abcdef0123456789abcdea",
      "kind": "image",
      "url": "https://example.com/output.png",
      "expiresAt": "2026-09-02T00:00:10.000Z"
    }
  ],
  "error": null
}

인증

api-keystring필수

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

파라미터

idstringpath필수: Job 생성 응답에서 받은 ID로, 24자리 16진수 문자열입니다.

성공 응답

200 OK 실행 결과는 status로 확인하세요. queued·processing 응답에는 Retry-After: 5가 포함됩니다.

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

참고

상태 조회를 중단하거나 클라이언트 대기 시간이 지나도 Job은 취소되지 않습니다.

응답과 오류

Status	Code	설명
400	INVALID_INPUT	id가 24자리 16진수 문자열 형식이 아닙니다.
400	MULTIPLE_AUTH_CREDENTIALS	로그인 쿠키를 제외하고 api-key header만 보내세요.
401	AUTHENTICATION_REQUIRED	API key가 없거나 일치하지 않습니다.
403	USER_SUSPENDED, PRO_SUBSCRIPTION_REQUIRED, INVALID_INPUT	계정이 정지되었거나, Pro 구독이 활성화되어 있지 않거나, API 이용이 제한된 상태입니다.
404	JOB_NOT_FOUND	존재하지 않거나 다른 사용자 소유이거나 Comfy prompt API로 생성한 Job이 아닙니다.
500	INTERNAL_ERROR	서버 내부 오류입니다.