Image to Text (describe)

You can use Midjourney to describe an image that you upload and define. Describe is useful when you want to convert an image to text prompt.

Please make sure the image is not huge, file size less than 1MB is recommended.

If you don't know where to upload your image, you can use this tool to upload your image to our server, and copy the image URL.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

url

string

required

The public URL for the image.

ref

string

optional

The reference metadata which will return as part of the webhook.

webhookOverride

string

optional

The webhook URL which the response will send to, the payload of this webhook is same as our Message endpoint.

timeout

integer

optional

Custom timeout, default to 900 in seconds

>= 10<= 900

Default:

900

Example

{
  "url": "https://cdn.discordapp.com/attachments/123/123/123.png"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

success

boolean

required

The status of the request.

messageId

string

required

The messageId of the request, which will be used for querying the progress, sending subsequential actions later, etc.

createdAt

string

required

The timestamp of the job creation.

error

string

optional

The error message, if any

Example

{
    "success": true,
    "messageId": "d15c1541-229a-442b-9873-d3494dede12a",
    "createdAt": "2023-08-01T14:03:01.817Z"
}