curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.1",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv81",
  "model": "mj-v8.1",
  "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-v8.1",
    "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 V8.1

Midjourney V8.1 Image Generation

Midjourney V8.1 model supports generating high-quality images via natural language prompts. Fast mode returns 4 images per generation; Draft mode returns 24 lightweight 0.5K sketch images in a single run
Supports text-to-image and image-to-image (reference image URLs in prompt)
V8.1 highlights: native HD output (quality=hd), roughly 5x faster generation than the previous generation, improved text rendering (text wrapped in quotation marks renders more accurately), and stronger prompt adherence
Compatible with V7 assets: Style Reference (--sref) and Omni Reference (--oref) are supported, see Prompt Parameter Guide
Async processing mode, use the returned task ID to query status
Generated image links are valid for 30 days, please save them promptly
Timeout: approximately 20 minutes
Parameter notes: this route runs on V8.1 and does not support niji; set the speed mode via model_params.speed and the output quality via the top-level quality parameter

POST

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-v8.1",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv81",
  "model": "mj-v8.1",
  "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-v8.1",
    "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

Authorization

string

header

required

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

enum<string>

default:mj-v8.1

required

Model name

Available options:

mj-v8.1

prompt

string

required

Prompt, supports all Midjourney V8.1 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: 1024

Example:

"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"

quality

enum<string>

default:standard

Output quality

standard: Standard resolution (default), 1x multiplier
hd: Native HD output, 1.5x multiplier. Mutually exclusive with speed: draft

Pricing note: the quality multiplier is combined (multiplied) with the speed multiplier.

Available options:

standard,

hd

model_params

object

Model parameters

Show child attributes

callback_url

string<uri>

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 2048 characters

Callback mechanism:

Timeout: 10 seconds
Up to 3 retries after failure (retries at 1s/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

created

integer

Task creation timestamp

Example:

1757165031

string

Task ID

Example:

"task-unified-1757165031-mjv81"

model

string

Actual model name used

Example:

"mj-v8.1"

object

enum<string>

Task object type

Available options:

image.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Async task info

Show child attributes

type

enum<string>

Task output type

Available options:

text,

image,

audio,

video

Example:

"image"

usage

object

Usage and billing info

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Midjourney V8.1 Image Generation

Authorizations

All endpoints require Bearer Token authentication

Body

Response