---
title: "タスク詳細の取得"
description: "ID を指定して生成タスクを取得し、状態（waiting、running、completed、cancelled、failed）と、生成されたメディアの ID・URL を確認します。"
canonical: "https://platform.pixai.art/ja/docs/api/task/getTask"
last-updated: "2026-11-02"
---

# タスク詳細の取得

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.ja.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`
  タスクが見つかりません
