Describe

The Describe API accepts one Base64-encoded image and creates an asynchronous image-description task. Include the correct MIME type prefix and follow the image format and size limits documented in the field definitions.

POST/mj/submit/describe

Create an image-description task from an input image.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

Describe task parameters.

TypeScript Definitions

Use the request body type in TypeScript.

accountFilter?

Optional account filters.

notifyHook?string

Valid callback URL invoked when the task completes. Pass an empty string to use the platform-configured default callback URL.

state?string

Caller-provided state value used to correlate requests with callbacks.

botType?BotType

Bot type to use. MID_JOURNEY selects Midjourney, and NIJI_JOURNEY selects Niji Journey.

Default"MID_JOURNEY"

Value in

"MID_JOURNEY"
"NIJI_JOURNEY"

base64*string

Base64-encoded image to describe. Include the MIME type prefix and keep the image within 4 MB.

Length1 <= length

Response Body

`application/json`

curl -X POST "https://example.com/mj/submit/describe" \  -H "Content-Type: application/json" \  -d '{    "botType": "MID_JOURNEY",    "base64": "data:image/png;base64,IMAGE_BASE64",    "accountFilter": {      "channelId": "",      "instanceId": "",      "modes": [],      "remark": "",      "remix": true,      "remixAutoConsidered": true    },    "notifyHook": "",    "state": "request-003"  }'

{
  "code": 1,
  "description": "Submitted successfully",
  "properties": {},
  "result": 1320098173412546
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`