---
title: "POST /check-midjourney-status"
method: POST
path: "/check-midjourney-status"
---

# POST /check-midjourney-status

`POST /check-midjourney-status`

## Request

- Base URL: `https://api.nano-gpt.com/api`
- URL: `https://api.nano-gpt.com/api/check-midjourney-status`
- Auth: API key in header `x-api-key`

Check the status of an asynchronous Midjourney image generation task

## Request body

- CheckMidjourneyStatusRequest
  - `task_id` string, required: The unique identifier for the Midjourney generation task.

## Response `200`

Midjourney task status response

- CheckMidjourneyStatusResponse
  - `status` 'SUCCESS' | 'FAILED' | 'PENDING' | 'RUNNING' | 'IN_PROGRESS' | 'submitted' | 'NOT_START' | 'unknown', required: The current status of the Midjourney task.
  - `task_id` string, required: The unique identifier for the Midjourney generation task.
  - `progress` string, nullable: Optional progress indicator (e.g., "0%")
  - `imageUrl` string, uri, nullable: The URL of the generated image (present on SUCCESS).
  - `failReason` string, nullable: The reason for failure (present on FAILED).

## Other responses

- `400`: Bad Request (e.g., missing task_id)
- `401`: Unauthorized (invalid API key)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)
