curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mj-v7",
"prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
"model_params": {
"speed": "fast"
}
}
'{
"created": 1757165031,
"id": "task-unified-1757165031-mjv7",
"model": "mj-v7",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 45
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 1.8,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: mj-v7",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Midjourney V7
Midjourney V7 Image Generation
- Midjourney V7 model supports generating high-quality images via natural language prompts, 4 images per generation
- Supports text-to-image and image-to-image (reference image URLs in prompt)
- Supports all V7 native parameter syntax (e.g. —ar, —s, —c), see Prompt Parameter Guide
- Async processing mode, use the returned task ID to query status
- Generated image links are valid for 24 hours, please save them promptly
- Timeout: approximately 20 minutes
- System protection:
--v/--versionlocked to V7,--nijinot supported,--fast/--turbo/--draftmust be controlled viamodel_params.speed(these parameters in prompt will be automatically removed)
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mj-v7",
"prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
"model_params": {
"speed": "fast"
}
}
'{
"created": 1757165031,
"id": "task-unified-1757165031-mjv7",
"model": "mj-v7",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 45
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 1.8,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: mj-v7",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Midjourney has a built-in content moderation system. If some generated images are filtered by moderation, credits consumed for that request will not be refunded. Please ensure your prompts comply with content guidelines.
Authorizations
All endpoints require Bearer Token authentication
Get API Key:
Visit API Key Management Page to get your API Key
Add to request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Model name
Available options:
mj-v7 Prompt, supports all Midjourney V7 native parameter syntax (e.g. --ar 16:9 --s 500).
Image-to-Image: Place image URLs at the beginning of the prompt. Supported formats: .png, .gif, .webp, .jpg, .jpeg
Image-to-Image Rules:
- 1 image + no text = invalid (will return error)
- 1 image + text description = valid
- 2+ images + no text = valid
- 2+ images + text description = valid
Maximum string length:
8192Example:
"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"
Model parameters
Show child attributes
Show child attributes
HTTPS callback URL for task completion
Callback timing:
- Triggered when task is completed, failed, or cancelled
- Sent after billing confirmation
Security restrictions:
- HTTPS protocol only
- Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback mechanism:
- Timeout:
10seconds - Up to
3retries after failure (retries at1s/2s/4s after failure) - Callback response body format matches the task query endpoint
- A 2xx status code is considered successful; other status codes trigger retries
Example:
"https://your-domain.com/webhooks/image-task-completed"
Response
Task created successfully
Task creation timestamp
Example:
1757165031
Task ID
Example:
"task-unified-1757165031-mjv7"
Actual model name used
Example:
"mj-v7"
Task object type
Available options:
image.generation.task Task progress percentage (0-100)
Required range:
0 <= x <= 100Example:
0
Task status
Available options:
pending, processing, completed, failed Example:
"pending"
Async task info
Show child attributes
Show child attributes
Task output type
Available options:
text, image, audio, video Example:
"image"
Usage and billing info
Show child attributes
Show child attributes