Midjourney Image to Image

midjourney_V8.1_i2i

midjourney_V8.1_i2i Midjourney Image to Image Midjourney 图像生成 图像编辑 image generation image editing

Midjourney Image to Image creates variations from a selected image in an existing Midjourney task, supporting subtle or strong transformations.

MidJourney interface notes

MidJourney endpoints are split into direct generation and secondary editing. Direct generation only requires a prompt and other required fields to create an image. Secondary editing requires an upstream task ID and an image number from a previous task. midjourney_V8.1_i2i is a secondary editing endpoint.

Workflow

This model performs image-to-image transformation based on an existing Midjourney task result. First create a midjourney_V8.1_t2i text-to-image task to obtain the upstream task identifier, then pass it as jobId in this endpoint and use image_no to specify the image number to transform.

Prompt parameters

In the remix_prompt field, official prompt parameters must be appended to the same string instead of being passed as separate JSON fields. Multiple parameters can be used in one prompt.

Prompt tips

• Use short, clear, specific descriptions and prioritize what should appear in the image.
• Use concrete numbers when possible, such as “three cats” instead of “cats”.
• Use --no to exclude content instead of only describing what you do not want in natural language.
• Add important details around subject, medium, environment, lighting, color, mood, and composition.

Common control parameters

Parameter	Meaning	Values and notes
--ar / --aspect	Aspect ratio	Sets the output image aspect ratio, for example --ar 16:9. Ratios greater than 2:1 are experimental and may produce unpredictable results.
:: / ::<weight>	Multi-prompt and weights	Splits prompt fragments with double colons and optionally adds weights, for example space::2 ship. The total weight must be positive.
{option1,option2}	Permutation prompts	Uses braces to generate multiple prompt variants, for example a {red,green,yellow} bird. Each generated prompt is billed separately.
--v / --version	Model version	Use --v 8.1. Examples and requests in these docs use --v 8.1 consistently.
--iw	Image weight	Controls how strongly image prompts affect the result relative to text prompts. The default is 1.
--draft	Draft mode	Enables faster draft generation. Availability depends on the current model capability.
--no	Negative prompt	Specifies content that should not appear, for example --no plants.
--quality / --q	Quality and render time	Controls render effort and GPU usage. Common values include 0.25, 0.5, and 1; some versions support 2.
--repeat / --r	Repeat generation	Creates multiple tasks from the same prompt. The official range is 1-40.
--seed	Seed	Specifies an integer from 0-4294967295. The same prompt and seed usually produce similar results.
--stop	Early stop	Stops the task at a percentage from 10-100. Lower values usually create blurrier results with fewer details.
--relax / --fast / --turbo	Generation speed	Overrides the current setting and runs the current task in slow, fast, or turbo mode.
--stylize / --s	Stylization	Controls the strength of the default aesthetic algorithm. The default is usually 100; common range is 0-1000.
--chaos / --c	Diversity	Controls variation and unpredictability, from 0-100. Higher values create more divergent results.
--weird / --w	Weirdness	Explores more unusual aesthetics. Common range is 0-3000.
--style	Style mode	The main model commonly uses --style raw to reduce default beautification. Niji 5 can use cute, expressive, original, or scenic.
--exp	Creative style	Range 0-100. Higher values usually make images more detailed, lively, and creative.
--tile	Tile	Generates seamless repeatable patterns.

Image and style reference parameters

Parameter	Meaning	Values and notes
--sref <image URL|style code|random>	Style reference	References the visual style of an image or style code. Multiple sources can be combined, for example --sref URL1::2 URL2::1.
--sw	Style reference weight	Controls style reference strength, from 0-1000. The default is usually 100. --sw is not compatible with Moodboards.
--sv	Style reference version	Selects the style reference algorithm version. Availability depends on the current model capability.
--cref <image URL>	Character reference	Keeps character features from the reference image. Availability depends on the current model capability.
--cw	Character reference weight	Controls how much character detail is preserved, from 0-100. --cw 0 focuses more on the face; --cw 100 tries to preserve face, hair, clothing, and more details.
--oref <image URL>	Omni reference	Keeps consistency for the person, character, object, or vehicle in the reference image. Only one omni-reference image can be used at a time.
--ow	Omni reference weight	Controls omni-reference strength, from 1-1000. Higher values increase consistency, but very high values may make results unstable.

Examples

• A cinematic sunset landscape, ultra detailed --ar 16:9 --v 8.1 --s 250 --seed 1234
• A clean product photo of a glass teapot --oref https://example.com/object.png --ow 300 --sref https://example.com/style.png --sw 120 --no text, watermark

Examples in this documentation use --v 8.1. If a parameter does not take effect, rely on the current model capability and platform response.

Endpoints

POST /v1/queue/midjourney_V8.1_i2i # Create task

GET /v1/queue/midjourney_V8.1_i2i/requests/{request_id}/status # Query status

GET /v1/queue/midjourney_V8.1_i2i/requests/{request_id}/response # Get result

PUT /v1/queue/midjourney_V8.1_i2i/requests/{request_id}/cancel # Cancel task

Tip

Include the authentication header in each request: Authorization: Bearer YOUR_API_KEY.

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/midjourney_V8.1_i2i" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "jobId": "midjourney_provider_task_id",
    "image_no": 0,
    "type": 0,
    "remix_prompt": "Add warm sunset lighting and more architectural detail --v 8.1"
  }'

jobId string required

Upstream Midjourney task identifier from a previous midjourney_V8.1_t2i task result. Pass it as jobId in the SeaCloud request.

image_no int required

Image number used to select one image from the upstream midjourney_V8.1_t2i task result.

Range: 0 - 3

type int required

Variation type: 0 subtle, 1 strong.

Options: 0, 1

remix_prompt string

New prompt describing the desired changes for this variation. Midjourney/Youchuan prompt parameters can be appended to the same string, such as --s 250, --seed 1234, or --no text, watermark. These parameters are not passed as separate JSON fields.

Length range: 1 - 8192 characters

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/midjourney_V8.1_i2i/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/midjourney_V8.1_i2i/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/midjourney_V8.1_i2i/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
request_id	string	Task ID used for all follow-up operations.
response_url	string	URL for retrieving the final result.
status_url	string	URL for querying task status.
cancel_url	string	URL for canceling the task.
queue_position	int	Queue position.

Follow-up operations

Query status

Get result

Cancel task

Error handling