Midjourney Task Query

curl --request GET \
  --url https://zx1.deepwl.net/mj/task/{id}/fetch \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://zx1.deepwl.net/mj/task/{id}/fetch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://zx1.deepwl.net/mj/task/{id}/fetch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://zx1.deepwl.net/mj/task/{id}/fetch"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/mj/task/{id}/fetch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "Submit success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 0,
  "imageUrl": "",
  "videoUrl": "",
  "status": "IN_PROGRESS",
  "progress": "65%",
  "failReason": "",
  "buttons": null,
  "state": "",
  "imageUrls": []
}

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 1735689720000,
  "imageUrl": "https://.../image.png",
  "videoUrl": "",
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::xxx",
      "emoji": "",
      "label": "U1",
      "type": 2,
      "style": 2
    }
  ],
  "state": "",
  "imageUrls": [
    {
      "url": "https://.../image.png"
    }
  ]
}

GET

https://zx1.deepwl.net

task

{id}

fetch

Midjourney Task Query

curl --request GET \
  --url https://zx1.deepwl.net/mj/task/{id}/fetch \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://zx1.deepwl.net/mj/task/{id}/fetch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://zx1.deepwl.net/mj/task/{id}/fetch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://zx1.deepwl.net/mj/task/{id}/fetch"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/mj/task/{id}/fetch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "Submit success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 0,
  "imageUrl": "",
  "videoUrl": "",
  "status": "IN_PROGRESS",
  "progress": "65%",
  "failReason": "",
  "buttons": null,
  "state": "",
  "imageUrls": []
}

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 1735689720000,
  "imageUrl": "https://.../image.png",
  "videoUrl": "",
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::xxx",
      "emoji": "",
      "label": "U1",
      "type": 2,
      "style": 2
    }
  ],
  "state": "",
  "imageUrls": [
    {
      "url": "https://.../image.png"
    }
  ]
}

Midjourney Task Query

The Midjourney query API is used to poll task progress, retrieve final image information, and read task buttons and seed.

Single task queries use GET /mj/task/{id}/fetch
Batch queries use POST /mj/task/list-by-condition
Image seed queries use GET /mj/task/{id}/image-seed

Query a Single Task

GET /mj/task/{id}/fetch

curl https://zx1.deepwl.net/mj/task/1712158011464906/fetch \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Fields

string

Task ID.

string

Task action. Common values include IMAGINE, UPSCALE, VARIATION, ZOOM, PAN, DESCRIBE, BLEND, SHORTEN, SWAP_FACE.

string

Original prompt.

string

English prompt.

string

Task description.

integer

Submission time.

integer

Start execution time.

integer

End time.

string

Primary image URL.

string

Video URL.

string

Task status. Common values are NOT_START, SUBMITTED, MODAL, IN_PROGRESS, FAILURE, SUCCESS, CANCEL.

string

Task progress, for example 0%, 65%, 100%.

string

Reason for failure.

array<object> | null

Array of action buttons that can still be triggered below the image.

string

Custom parameter.

array<object> | array<string>

Image list.

Response Example

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "Submit success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 0,
  "imageUrl": "",
  "videoUrl": "",
  "status": "IN_PROGRESS",
  "progress": "65%",
  "failReason": "",
  "buttons": null,
  "state": "",
  "imageUrls": []
}

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 1735689720000,
  "imageUrl": "https://.../image.png",
  "videoUrl": "",
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::xxx",
      "emoji": "",
      "label": "U1",
      "type": 2,
      "style": 2
    }
  ],
  "state": "",
  "imageUrls": [
    {
      "url": "https://.../image.png"
    }
  ]
}

Query Tasks in Batch

POST /mj/task/list-by-condition

{
  "ids": [
    "1712158011464906"
  ]
}

The return value is an array of task objects, and the fields are basically the same as those in the single task query.

Get Task Image Seed

GET /mj/task/{id}/image-seed

{
  "code": 1,
  "description": "",
  "result": "1234567890"
}

Get Public Image

GET /mj/image/{id}

This endpoint proxies the task image and is suitable for directly downloading the final image:

curl -L https://zx1.deepwl.net/mj/image/1712158011464906 --output output.png

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

Midjourney Task Query

Midjourney Task Query

Query a Single Task

Response Fields

Response Example

Query Tasks in Batch

Get Task Image Seed

Get Public Image

​Midjourney Task Query

​Query a Single Task

​Response Fields

​Response Example

​Query Tasks in Batch

​Get Task Image Seed

​Get Public Image

​Related Endpoints

Midjourney Task Query

Query a Single Task

Response Fields

Response Example

Query Tasks in Batch

Get Task Image Seed

Get Public Image

Related Endpoints