---
title: "작업 조회"
description: "v2 엔드포인트로 생성한 작업을 조회합니다. status가 completed, failed, cancelled 중 하나가 될 때까지 몇 초마다 폴링하세요."
canonical: "https://platform.pixai.art/ko/docs/api-v2/task/getTask"
last-updated: "2026-11-02"
---

# 작업 조회

v2 엔드포인트로 생성한 작업을 조회합니다. `status`가 `completed`, `failed`, `cancelled` 중 하나가 될 때까지 몇 초마다 폴링하세요.



결과 위치:

* 이미지(`taskKind` `t2i`, `i2i`, `inpaint`): `outputs.mediaIds`와 `outputs.mediaUrls`.
* 동영상(`taskKind` `i2v-inhouse`, `reference-video`): `outputs.videoMediaId`. `GET /v2/media/batch?ids=<videoMediaId>`로 조회한 뒤 `fileUrl`을 다운로드하세요. 이때 `outputs.mediaIds`에는 포스터 이미지만 들어 있습니다.

생성된 미디어는 영구 보관되지 않습니다. 작업이 완료되면 가능한 한 빨리 결과를 다운로드해 주세요.

## GET https://api.pixai.art/v2/task/{id}

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

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

### Parameters

- `id` (in path, string, required)
  작업 ID입니다.
- `with_parameters` (in query, string, optional)
  `true`를 보내면 저장된 작업 파라미터가 `parameters`에 포함됩니다.
  Allowed values: `true`.

### Example (cURL)

```bash
curl https://api.pixai.art/v2/task/1943547603237249965 \
  -H "Authorization: Bearer $PIXAI_API_KEY"
```

### 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)
    작업 종료 시간.
  - `taskKind` (string, optional)
    작업이 만드는 것입니다. 이미지는 `t2i` 또는 `i2i`, `POST /v2/gen-task/inpaint`는 `inpaint`, `POST /v2/frame-video/create`는 `i2v-inhouse`, `POST /v2/reference-video/create`는 `reference-video`입니다.
  - `paidQuota` (integer, optional)
    작업에 청구된 크레딧.
  - `taskStatusMsgI18n` (object, optional)
    `failed`가 된 작업의 실패 이유.
  - `taskStatusMsgI18n.key` (string, optional)
    바뀌지 않는 메시지 키.
  - `taskStatusMsgI18n.defaultMessage` (string, optional)
    영어 메시지.
  - `outputs` (object, optional)
    작업에서 생성된 출력물.
  - `outputs.videoMediaId` (string, optional)
    동영상 작업의 경우 동영상의 미디어 ID입니다. `GET /v2/media/batch?ids=<videoMediaId>`로 조회한 뒤 `fileUrl`을 다운로드하세요. 이때 `mediaIds`에는 포스터 이미지만 들어 있습니다.
  - `outputs.seed` (string, optional)
    사용된 시드 값(10진수 문자열).
  - `outputs.mediaIds` (string[], optional)
    생성된 이미지의 미디어 ID입니다. 이 ID를 사용하여 각 생성 이미지의 상세 정보를 조회할 수 있습니다.

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

    생성된 이미지는 일반적으로 영구 보관되지 않으므로 가능한 한 빨리 다운로드해 주세요. 이미지가 사용 불가능한 경우 해당 항목이 `null`로 표시될 수 있습니다.
- `401`
  `UNAUTHORIZED`: API 키를 보내지 않았습니다. 잘못되었거나 폐기되었거나 만료된 키에는 숫자 `code`를 가진 `{"message": "invalid token", "code": 40100001}`이 반환됩니다.
- `404`
  `NOT_FOUND`: 이 ID의 작업이 없거나 조회할 권한이 없습니다. API 키 없이 요청하면 모든 작업에 이 응답이 반환됩니다.