---
title: "ID로 작업 상세 조회"
description: "ID로 생성 작업을 조회하여 상태(waiting, running, completed, cancelled, failed)와 생성된 미디어의 ID 및 URL을 확인합니다."
canonical: "https://platform.pixai.art/ko/docs/api/task/getTask"
last-updated: "2026-11-02"
---

# ID로 작업 상세 조회

ID로 생성 작업을 조회하여 상태(waiting, running, completed, cancelled, failed)와 생성된 미디어의 ID 및 URL을 확인합니다.



## GET https://api.pixai.art/v1/task/{taskId}

Authentication: send your API key as `Authorization: Bearer <API key>`.

Machine-readable OpenAPI spec: https://platform.pixai.art/openapi-spec.ko.yaml

### Parameters

- `taskId` (in path, string, required)
  반환할 작업 ID

### Responses

- `200`
  성공
  Body fields:
  - `id` (string, required)
    작업의 고유 식별자
  - `status` (string, required)
    작업 상태
    Allowed values: `waiting`, `running`, `completed`, `cancelled`, `failed`.
  - `createdAt` (string, required)
    작업 생성 시간
  - `updatedAt` (string, required)
    작업 최종 업데이트 시간
  - `startedAt` (string, optional)
    작업 시작 시간
  - `endAt` (string, optional)
    작업 종료 시간
  - `outputs` (object, optional)
    작업 출력
  - `outputs.mediaIds` (string[], optional)
    작업으로 생성된 미디어 ID. 이 ID를 사용해 생성된 미디어의 상세 정보를 조회할 수 있습니다.

    생성된 이미지는 일반적으로 영구 보관되지 않으므로 가능한 한 빨리 다운로드해 주세요.
  - `outputs.mediaUrls` ((string | null)[], optional)
    생성된 이미지의 공개 URL

    생성된 이미지는 일반적으로 영구 보관되지 않으므로 가능한 한 빨리 다운로드해 주세요.
    이미지가 사용 불가능한 경우 배열 내에 null이 포함될 수 있습니다.
  - `mediaSafetyLevel` (string, optional)
    생성된 이미지에 대한 콘텐츠 안전성 판정. 작업의 미디어 안전성 점수에서 파생됩니다.

    점수를 사용할 수 없는 경우(아직 심사되지 않음, 점수를 매길 미디어 없음, 심사 실패)에는 이 필드가 생략됩니다. 작업이 완료된 경우에도 생략될 수 있습니다. 생략되었다고 해서 안전하다는 의미는 아니며, 폴링을 계속해도 반드시 값이 채워지는 것은 아닙니다.
    Allowed values: `nsfw`, `safe`.
  - `textSafetyLevel` (string, optional)
    프롬프트 텍스트에 대한 콘텐츠 안전성 판정. 작업의 텍스트 안전성 점수에서 파생됩니다.

    점수를 사용할 수 없는 경우(아직 심사되지 않음, 점수를 매길 프롬프트 없음, 심사 실패)에는 이 필드가 생략됩니다. 작업이 완료된 경우에도 생략될 수 있습니다. 생략되었다고 해서 안전하다는 의미는 아니며, 폴링을 계속해도 반드시 값이 채워지는 것은 아닙니다.
    Allowed values: `nsfw`, `safe`.
- `404`
  작업을 찾을 수 없음
