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. diffusion is a Direct Generation 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_diffusion
text string required
Image generation text description, length must be between 1-8192 characters.
callback string
Callback URL, must start with http:// or https://.
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 |
| 8004001001 | Missing text |
| 8004001002 | Invalid text length |
| 8004001003 | Invalid callback URL |
| 8004001004 | Authentication failed |
| 8004001098 | Generation process failed |
| 8004001099 | Provider unavailable |