API method

Midjourney describe: image to prompt via API

Updated November 4, 2026

What it's used for

• Image-to-prompt services: a user uploads a picture and gets prompts to edit and generate from.
• Getting closer to a reference: describe it, then send one of the prompts to imagine.
• Text descriptions for an image library, for example as a starting point for alt text or tags.

Request

Base URL is https://api.userapi.ai. Every request needs two headers, api-key and Content-Type: application/json.

{
  "url": "https://example.com/image.jpg",
  "webhook_url": "https://example.com/describe/webhook-url",
  "webhook_type": "result",
  "account_hash": "a7d44910-88a6-4673-acc8-d60ffc3479a6"
}

Parameters

What comes back

The response is just the task hash, e.g. {"hash": "ed162774-9244-4038-bdf1-801b033809ec"}. The finished task is what you later get from GET /midjourney/v2/status?hash=… or in the webhook:

{
  "account_hash": "a7d44710-88a6-4673-acc8-d60ffc3479a6",
  "hash": "2d7116bf-3006-41e7-9fcc-f1628fc4693a",
  "prompt": "https://example.com/50a9.jpg",
  "type": "describe",
  "status": "done",
  "result": [
    "nice girl in the hat",
    "girl in the nice hat",
    "cute girl in the hat",
    "girl in the little hat"
  ],
  "status_reason": null,
  "created_at": "2006-01-02T15:04:05+00:00"
}

Note that result here is not an image but an array of four strings, and the promptfield contains the URL you sent.

Example with cURL

1. Send the image

curl -X POST https://api.userapi.ai/midjourney/v2/describe \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"url": "https://example.com/reference.jpg"}'

2. Get the prompts

When status is done, the prompts are in result:

curl "https://api.userapi.ai/midjourney/v2/status?hash=DESCRIBE_HASH" \
  -H "api-key: $USERAPI_KEY"

3. Generate from one of them

curl -X POST https://api.userapi.ai/midjourney/v2/imagine \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"prompt": "girl in the nice hat"}'

Wrappers for Python, Node.js and PHP are on separate pages. If you'd rather not write code, the same methods are available in n8n and Make. This method in the documentation.

If the image only exists on your disk or behind a login, upload it first with POST /midjourney/v2/upload. It takes a PNG or JPG (as a file or a link) and returns a Discord URL that you then pass to describe. Details: Upload.

Other methods