Skip to main content
POST
/
mj
/
submit
/
describe
cURL
IMAGE_B64=$(base64 < cat.jpg | tr -d '\n')

curl https://api.cometapi.com/mj/submit/describe \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"botType\": \"MID_JOURNEY\",
    \"base64\": \"data:image/jpeg;base64,$IMAGE_B64\"
  }"
{
  "code": 123,
  "description": "<string>",
  "properties": {},
  "result": 123
}
Use this endpoint to extract Midjourney-style prompt suggestions from an input image.

​
What this route is good for

  • Turning an image into prompt candidates you can remix
  • Extracting a visual direction before you start a fresh imagine task
  • Building a faster authoring loop when you do not want to write the first prompt from scratch

​
Task flow

1

Submit the image

Upload or reference the image you want Midjourney to describe and store the returned task id.
2

Poll the describe task

Use Fetch Single Task until the task completes and returns prompt-like output.
3

Reuse the generated prompt

Take the prompt candidate that fits your intent and continue with Imagine for a fresh generation pass.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
base64
string
default:data:image/png;base64,<your-image-base64>
required

Base64-encoded image to describe. Use a data URI such as data:image/png;base64,xxx. Provide either base64 or link.

​
link
string
default:https://your-image-host/source.png
required

URL of the image to describe. Provide either link or base64.

​
botType
enum<string>

Bot type to use. MID_JOURNEY for Midjourney (default), NIJI_JOURNEY for Niji.

Available options:
NIJI_JOURNEY,
MID_JOURNEY
​
state
string

Custom state string. Returned as-is in the task result and webhook callback for your own tracking.

Response

200 - application/json

Success

​
code
integer
required

Submission status code. 1 = submitted successfully (result carries the task id). 21 = the action opened a confirmation modal; continue with /mj/submit/modal using the returned task id. 4 = parameter error; description explains the cause.

​
description
string
required
​
properties
object
required
​
result
integer
required