Skip to main content
POST
/
mj
/
submit
/
imagine
cURL
curl https://api.deerapi.com/mj/submit/imagine \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "botType": "MID_JOURNEY",
    "prompt": "a paper boat floating on calm water at sunrise --v 6.1",
    "accountFilter": {
      "modes": [
        "FAST"
      ]
    }
  }'
{
  "code": 1,
  "description": "Use this field according to the endpoint schema.",
  "result": "1773314942177684",
  "properties": {
    "discordChannelId": "5e6ca8e1f40e4de6",
    "discordInstanceId": "5e6ca8e1f40e4de6"
  }
}

​
Overview

Use this endpoint to call the Midjourney Submit Imagine workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

​
Before you start

Use the DeerAPI base URL and pass your API Key in the Authorization header: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

​
Implementation notes

  • Use the OpenAPI playground for the exact request fields accepted by this endpoint.
  • Keep API Keys on the server side when you build production applications.
  • Log the request ID from failed calls so support can investigate the request.
  • Retry 429, 500, and 503 responses with exponential backoff.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

Body

application/json
​
prompt
string
required

Text prompt for the generation. Supports standard Midjourney parameters such as --v, --ar, --stylize, etc.

Example:

"a paper boat floating on calm water at sunrise --v 6.1"

​
botType
enum<string>
default:MID_JOURNEY

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

Available options:
MID_JOURNEY,
NIJI_JOURNEY
​
accountFilter
object

Filter which Midjourney account modes may be used for this task.

​
base64Array
string[]

Base64-encoded reference images. Each item should be a data URI such as data:image/png;base64,xxx.

​
state
string

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

Response

200 - application/json

Task accepted.

​
code
integer
required
​
description
string
required
​
result
string
required

Task id returned after submission.

​
properties
object