MiniMax H3 Image Edit API

 1# pip install "segmind>=1.1.0"
 2# export SEGMIND_API_KEY="YOUR_API_KEY"
 3import segmind
 4
 5# Async (v2): submit to the queue and block until COMPLETED.
 6# run() returns the final result dict (600s deadline, 1.0s poll by default).
 7result = segmind.run(
 8    "minimax-h3-image-edit",
 9    reference_images=["https://segmind-resources.s3.amazonaws.com/input/minimax-h3-image-edit-elephant-683ded41.jpg", "https://segmind-resources.s3.amazonaws.com/input/minimax-h3-image-edit-giraffe-1dac0d32.jpg"],
10    prompt="Picture 1 is a mustard hand-knitted plush elephant; Picture 2 is a wooden pull-along giraffe. Seat the knitted elephant from Picture 1 upright on the back of the wooden giraffe from Picture 2, on a pale birch nursery shelf with a window of diffused daylight to the left. Keep the elephant's chunky knit stitches, its red felt heart and black bead eyes exactly as in Picture 1, and keep the giraffe's painted brown spots, red pull-string and black wheels exactly as in Picture 2.",
11    speed="standard",
12    num_images=1,
13    area="4K",
14    aspect_ratio="4:3",
15)
16print(result["status"])                      # COMPLETED
17print(result.get("output"))                  # model output (e.g. media URL)
18print(result["metrics"]["inference_time"])   # server compute seconds
19
20# --- Or submit + poll manually (track request_id, control the cadence) ---
21from segmind import SegmindClient, InferenceFailed, InferenceTimeout
22
23client = SegmindClient()                      # reads SEGMIND_API_KEY
24payload = {
25    "reference_images": ["https://segmind-resources.s3.amazonaws.com/input/minimax-h3-image-edit-elephant-683ded41.jpg", "https://segmind-resources.s3.amazonaws.com/input/minimax-h3-image-edit-giraffe-1dac0d32.jpg"],
26    "prompt": "Picture 1 is a mustard hand-knitted plush elephant; Picture 2 is a wooden pull-along giraffe. Seat the knitted elephant from Picture 1 upright on the back of the wooden giraffe from Picture 2, on a pale birch nursery shelf with a window of diffused daylight to the left. Keep the elephant's chunky knit stitches, its red felt heart and black bead eyes exactly as in Picture 1, and keep the giraffe's painted brown spots, red pull-string and black wheels exactly as in Picture 2.",
27    "speed": "standard",
28    "num_images": 1,
29    "area": "4K",
30    "aspect_ratio": "4:3",
31}
32job = client.submit_async("minimax-h3-image-edit", **payload)
33print(job.request_id)                         # available immediately
34try:
35    result = job.wait(timeout=600, interval=1.0)
36except InferenceTimeout as e:
37    print("still running:", e.request_id)
38except InferenceFailed as e:
39    print("failed:", e.detail)