---
title: "タスクの取得"
description: "任意の v2 エンドポイントで作成したタスクを取得します。status が completed、failed、cancelled のいずれかになるまで、数秒ごとにポーリングしてください。"
canonical: "https://platform.pixai.art/ja/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.ja.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 キーなしのリクエストでは、どのタスクでもこの応答になります。