Midjourney API

Community model card for calling Midjourney through a REST API.

Midjourney has no official public API. This repo documents the midjourney model as exposed by Apiframe: text-to-image on V8.2, a 4-image grid per job, and follow-up actions (upsample, variation, inpaint, outpaint, pan). Image-to-video is a separate model id, midjourney-video.

This repository does not host weights. Midjourney is a closed model. Inference runs remotely.

Model description


Architecture	Midjourney V8.2 (current default)
Task	text-to-image; image-to-image via follow-up actions
Output	4 images + `gridUrl`
Aspect ratios	`1:1`, `3:4`, `4:3`, `9:16`, `16:9`, `21:9`
Typical latency	~50s

How to use

pip install requests

import os
import time
import requests

API = "https://api.apiframe.ai/v2"
headers = {
    "X-API-Key": os.environ["APIFRAME_API_KEY"],
    "Content-Type": "application/json",
}

job = requests.post(
    f"{API}/images/generate",
    headers=headers,
    json={
        "model": "midjourney",
        "prompt": "editorial still life of a red heirloom tomato and mimosa, cobalt background",
        "midjourneyParams": {"aspect_ratio": "16:9"},
    },
).json()

while True:
    result = requests.get(f"{API}/jobs/{job['jobId']}", headers=headers).json()
    if result["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)

print(result.get("result"))

result["images"] is a list of 4 CDN URLs. Pass webhookUrl on the generate call if you do not want to poll.

Follow-up actions

import os
import requests

headers = {
    "X-API-Key": os.environ["APIFRAME_API_KEY"],
    "Content-Type": "application/json",
}

requests.post(
    "https://api.apiframe.ai/v2/images/midjourney/action",
    headers=headers,
    json={
        "parentJobId": "JOB_ID",
        "action": "upsample",  # variation | inpaint | outpaint | pan
        "index": 1,            # 1-4
    },
)

Image-to-video

import os
import requests

headers = {
    "X-API-Key": os.environ["APIFRAME_API_KEY"],
    "Content-Type": "application/json",
}

requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers=headers,
    json={
        "model": "midjourney-video",
        "prompt": "slow push in, soft daylight",
        "midjourneyVideoParams": {
            "start_image": "https://example.com/still.jpg",
            "motion": "low",
            "resolution": "hd",
        },
    },
)

Limitations

Closed model. No weights, fine-tuning, or local inference.
Not an official Midjourney endpoint. Requires an Apiframe API key (X-API-Key).
Commercial use follows Midjourney's terms.
Generated media is retained on the CDN for 90 days.

License

Outputs are subject to Midjourney's terms. This card is documentation only. Apiframe is not affiliated with, endorsed by, or sponsored by Midjourney, Inc.

Downloads last month: -; Downloads are not tracked for this model. How to track