MidJourney API Notes
The MidJourney API is divided into two categories: Direct Generation and Secondary Editing. Direct Generation only requires providing necessary parameters such as prompts to generate images directly. Secondary Editing requires providing the previous task ID and image number to execute image generation. variation is a Secondary Editing category
Authentication
authorization string required
All APIs require authentication via Bearer Token.
Get API Key:
Visit API Key Management Page to get your API Key
Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEYParameters
model string required
Model ID to use for the request.
Value: midjourney_variation
jobId string required
Job ID.
imageNo integer required
Image number, range 0-3.
Options: 0, 1, 2, 3
type integer required
Variation type: 0 (subtle), 1 (strong).
Options: 0, 1
callback string
Callback URL, must start with http:// or https://.
remixPrompt string
Remix prompt, length must be between 1-8192 characters.
Polling
Since result generation takes time, you need to poll the task status after creating the task.
The initial response only returns information such as the task ID and initial status. The final result must be obtained by polling the task status endpoint using the task ID.
See the examples on the right for polling requests and responses.
Response Format
error object
Error information. Only present when status is failed.
code
integerError code.
error_message
stringDetailed error message.
output array
Generation results. Only present when status is completed.
content
arrayList of generated content.
type
stringResource type, e.g.,
video,image.url
stringGenerated content URL.
usage object
Usage statistics. Only present when status is completed.
cost
stringTotal cost in USD.
discount
numberDiscount amount.
metadata object
Metadata information.
Error Codes
| Error Code | Description |
|---|---|
| 0 | No error |
| 8004004001 | Job ID missing |
| 8004004002 | Image number missing |
| 8004004003 | Invalid image number |
| 8004004004 | Type missing |
| 8004004005 | Invalid type |
| 8004004006 | Invalid callback URL |
| 8004004007 | Invalid remix prompt length |
| 8004004098 | Generation process failed |
| 8004004099 | Provider unavailable |