Image Generation

diffusion(text, callback=None)

Create a new text-to-image generation task.

response = client.midjourney.diffusion(
    text="a serene mountain landscape at sunset",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

text (str): Text prompt (1-8192 characters)
callback (str, optional): Webhook URL

Returns: TaskResponse with job_id and status

variation(job_id, image_no, type, remix_prompt=None, callback=None)

Create variations of a generated image.

response = client.midjourney.variation(
    job_id="original-job-id",
    image_no=0,
    type=1,  # 0=Subtle, 1=Strong
    remix_prompt="add more clouds",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
type (int): Variation intensity (0=Subtle, 1=Strong)
remix_prompt (str, optional): Additional guidance
callback (str, optional): Webhook URL

upscale(job_id, image_no, type, callback=None)

Upscale a generated image.

response = client.midjourney.upscale(
    job_id="original-job-id",
    image_no=0,
    type=1,  # 0=Subtle, 1=Creative
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
type (int): Upscaling type (0=Subtle, 1=Creative)
callback (str, optional): Webhook URL

reroll(job_id, callback=None)

Regenerate with the same prompt.

response = client.midjourney.reroll(
    job_id="original-job-id",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
callback (str, optional): Webhook URL

blend(img_urls, aspect_ratio, callback=None)

Blend 2-5 images together.

response = client.midjourney.blend(
    img_urls=[
        "https://example.com/image1.png",
        "https://example.com/image2.png"
    ],
    aspect_ratio="1:1",  # "2:3", "1:1", or "3:2"
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

img_urls (list): List of 2-5 image URLs
aspect_ratio (str): Image ratio (“2:3”, “1:1”, or “3:2”)
callback (str, optional): Webhook URL

describe(img_url, callback=None)

Generate text descriptions from an image.

response = client.midjourney.describe(
    img_url="https://example.com/image.png",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

img_url (str): URL of image to describe
callback (str, optional): Webhook URL

shorten(prompt, callback=None)

Optimize and shorten a prompt.

response = client.midjourney.shorten(
    prompt="a very detailed and long prompt text...",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

prompt (str): Prompt text to optimize
callback (str, optional): Webhook URL

pan(job_id, image_no, direction, scale, remix_prompt=None, callback=None)

Extend image in a specific direction.

response = client.midjourney.pan(
    job_id="original-job-id",
    image_no=0,
    direction=0,  # 0=Down, 1=Right, 2=Up, 3=Left
    scale=1.5,    # 1.1-3.0
    remix_prompt="add mountains",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
direction (int): Direction to pan (0=Down, 1=Right, 2=Up, 3=Left)
scale (float): Expansion scale (1.1-3.0)
remix_prompt (str, optional): Additional guidance
callback (str, optional): Webhook URL

outpaint(job_id, image_no, scale, remix_prompt=None, callback=None)

Expand image in all directions.

response = client.midjourney.outpaint(
    job_id="original-job-id",
    image_no=0,
    scale=1.3,  # 1.1-2.0
    remix_prompt="add forest background",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
scale (float): Expansion scale (1.1-2.0)
remix_prompt (str, optional): Additional guidance
callback (str, optional): Webhook URL

inpaint(job_id, image_no, mask, remix_prompt=None, callback=None)

Edit specific regions using a mask.

with open("mask.png", "rb") as f:
    mask_data = f.read()

response = client.midjourney.inpaint(
    job_id="original-job-id",
    image_no=0,
    mask=mask_data,
    remix_prompt="add a rainbow in the sky",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
mask (bytes): Binary mask data (PNG format)
remix_prompt (str, optional): Description of edits
callback (str, optional): Webhook URL

remix(job_id, image_no, remix_prompt, mode=None, callback=None)

Transform image with a new prompt.

response = client.midjourney.remix(
    job_id="original-job-id",
    image_no=0,
    remix_prompt="turn into a watercolor painting",
    mode=0,  # 0=Strong, 1=Subtle
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
remix_prompt (str): New prompt for transformation
mode (int, optional): Remix strength (0=Strong, 1=Subtle)
callback (str, optional): Webhook URL

edit(job_id, image_no, canvas, img_pos, remix_prompt, mask=None, callback=None)

Edit with canvas positioning.

from legnext.types import Canvas, CanvasImg, Mask, Polygon

response = client.midjourney.edit(
    job_id="original-job-id",
    image_no=0,
    canvas=Canvas(width=1024, height=1024),
    img_pos=CanvasImg(width=512, height=512, x=256, y=256),
    remix_prompt="change the sky to sunset colors",
    mask=Mask(areas=[
        Polygon(width=1024, height=1024, points=[100, 100, 500, 100, 500, 500, 100, 500])
    ]),
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
canvas (Canvas): Canvas dimensions (width, height)
img_pos (CanvasImg): Image positioning on canvas
remix_prompt (str): Description of edits
mask (Mask, optional): Mask with polygon areas
callback (str, optional): Webhook URL

upload_paint(img_url, canvas, img_pos, remix_prompt, mask, callback=None)

Advanced painting on uploaded images.

from legnext.types import Canvas, CanvasImg, Mask

response = client.midjourney.upload_paint(
    img_url="https://example.com/image.png",
    canvas=Canvas(width=1024, height=1024),
    img_pos=CanvasImg(width=768, height=768, x=128, y=128),
    remix_prompt="add magical effects",
    mask=Mask(url="https://example.com/mask.png"),
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

img_url (str): URL of image to paint on
canvas (Canvas): Canvas dimensions (width, height)
img_pos (CanvasImg): Image positioning on canvas
remix_prompt (str): Description of effects
mask (Mask): Mask with URL
callback (str, optional): Webhook URL

retexture(img_url, remix_prompt, callback=None)

Change textures and surfaces.

response = client.midjourney.retexture(
    img_url="https://example.com/image.png",
    remix_prompt="metallic and shiny surfaces",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

img_url (str): URL of image to retexture
remix_prompt (str): Texture description
callback (str, optional): Webhook URL

remove_background(img_url, callback=None)

Remove the background from an image.

response = client.midjourney.remove_background(
    img_url="https://example.com/image.png",
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

img_url (str): URL of image to process
callback (str, optional): Webhook URL

enhance(job_id, image_no, callback=None)

Enhance image quality (draft to high-res).

response = client.midjourney.enhance(
    job_id="draft-job-id",
    image_no=0,
    callback="https://your-domain.com/webhook"  # Optional
)

Parameters:

job_id (str): Original image task ID
image_no (int): Image index (0-3)
callback (str, optional): Webhook URL

Overview

Client Libraries

diffusion(text, callback=None)

variation(job_id, image_no, type, remix_prompt=None, callback=None)

upscale(job_id, image_no, type, callback=None)

reroll(job_id, callback=None)

blend(img_urls, aspect_ratio, callback=None)

describe(img_url, callback=None)

shorten(prompt, callback=None)

pan(job_id, image_no, direction, scale, remix_prompt=None, callback=None)

outpaint(job_id, image_no, scale, remix_prompt=None, callback=None)

inpaint(job_id, image_no, mask, remix_prompt=None, callback=None)

remix(job_id, image_no, remix_prompt, mode=None, callback=None)

edit(job_id, image_no, canvas, img_pos, remix_prompt, mask=None, callback=None)

upload_paint(img_url, canvas, img_pos, remix_prompt, mask, callback=None)

retexture(img_url, remix_prompt, callback=None)

remove_background(img_url, callback=None)

enhance(job_id, image_no, callback=None)

Next Steps

​diffusion(text, callback=None)

​variation(job_id, image_no, type, remix_prompt=None, callback=None)

​upscale(job_id, image_no, type, callback=None)

​reroll(job_id, callback=None)

​blend(img_urls, aspect_ratio, callback=None)

​describe(img_url, callback=None)

​shorten(prompt, callback=None)

​pan(job_id, image_no, direction, scale, remix_prompt=None, callback=None)

​outpaint(job_id, image_no, scale, remix_prompt=None, callback=None)

​inpaint(job_id, image_no, mask, remix_prompt=None, callback=None)

​remix(job_id, image_no, remix_prompt, mode=None, callback=None)

​edit(job_id, image_no, canvas, img_pos, remix_prompt, mask=None, callback=None)

​upload_paint(img_url, canvas, img_pos, remix_prompt, mask, callback=None)

​retexture(img_url, remix_prompt, callback=None)

​remove_background(img_url, callback=None)

​enhance(job_id, image_no, callback=None)

​Next Steps

diffusion(text, callback=None)

variation(job_id, image_no, type, remix_prompt=None, callback=None)

upscale(job_id, image_no, type, callback=None)

reroll(job_id, callback=None)

blend(img_urls, aspect_ratio, callback=None)

describe(img_url, callback=None)

shorten(prompt, callback=None)

pan(job_id, image_no, direction, scale, remix_prompt=None, callback=None)

outpaint(job_id, image_no, scale, remix_prompt=None, callback=None)

inpaint(job_id, image_no, mask, remix_prompt=None, callback=None)

remix(job_id, image_no, remix_prompt, mode=None, callback=None)

edit(job_id, image_no, canvas, img_pos, remix_prompt, mask=None, callback=None)

upload_paint(img_url, canvas, img_pos, remix_prompt, mask, callback=None)

retexture(img_url, remix_prompt, callback=None)

remove_background(img_url, callback=None)

enhance(job_id, image_no, callback=None)

Next Steps