MiniMax-H3-Image 图片生成 API

curl 'https://cp.compshare.cn/image/v1/config?model=MiniMax-H3-Image' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

{
  "model": "MiniMax-H3-Image",
  "available": true,
  "unavailable_reason": "",
  "price_version": "1",
  "prices": {
    "1K": {"base": 12, "per_reference": 3},
    "2K": {"base": 13, "per_reference": 3},
    "4K": {"base": 38, "per_reference": 3}
  },
  "moderation_available": true,
  "reference_moderation_available": true,
  "prompt_optimization_available": true,
  "prompt_optimization_default_enabled": true
}

单张积分费用 = 所选档位的 base + per_reference × 参考图张数

POST https://cp.compshare.cn/image/v1/tasks

curl -X POST 'https://cp.compshare.cn/image/v1/tasks' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: h3-image-text-001' \
  -d '{
    "model": "MiniMax-H3-Image",
    "prompt": "山谷中的木屋，清晨薄雾，远山层叠，电影感光影",
    "aspect_ratio": "21:9",
    "resolution": "4K"
  }'

{"task_id": "<TASK_ID>"}

curl -X POST 'https://cp.compshare.cn/image/v1/tasks' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: h3-image-reference-001' \
  -d '{
    "model": "MiniMax-H3-Image",
    "prompt": "将图 1 中的角色放入图 2 的场景，保持角色服装不变，水彩风格",
    "aspect_ratio": "4:5",
    "resolution": "2K",
    "reference_images": [
      {"asset_id": "<ASSET_ID_1>"},
      {"asset_id": "<ASSET_ID_2>"}
    ]
  }'

curl 'https://cp.compshare.cn/image/v1/tasks/<TASK_ID>' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

{
  "task": {
    "task_id": "<TASK_ID>",
    "status": "succeeded",
    "can_cancel": false,
    "input": {
      "model": "MiniMax-H3-Image",
      "prompt": "山谷中的木屋，清晨薄雾，远山层叠，电影感光影",
      "optimize_prompt": false,
      "aspect_ratio": "21:9",
      "resolution": "4K",
      "width": 6272,
      "height": 2688,
      "output_format": "png",
      "reference_images": []
    },
    "prompt_optimization": {"status": "disabled"},
    "point_cost": 38,
    "point_status": "consumed",
    "output_url": "https://example.com/generated/h3-image.png"
  }
}

import json
import os
import time
import uuid
from pathlib import Path
from urllib.request import Request, urlopen
 
BASE_URL = "https://cp.compshare.cn"
API_KEY = os.environ["COMPSHARE_API_KEY"]
MODEL = "MiniMax-H3-Image"
RESOLUTION = "2K"
 
 
def api(method, path, body=None, idempotency_key=None):
    headers = {"Authorization": f"Bearer {API_KEY}", "Accept": "application/json"}
    data = None
    if body is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(body, ensure_ascii=False).encode("utf-8")
    if idempotency_key:
        headers["Idempotency-Key"] = idempotency_key
    request = Request(BASE_URL + path, data=data, headers=headers, method=method)
    # 非 2xx 响应由 urlopen 抛出 HTTPError；2xx 响应仍需检查业务错误。
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
    if result.get("RetCode", 0) != 0 or "error" in result:
        raise RuntimeError(result)
    return result
 
 
config = api("GET", f"/image/v1/config?model={MODEL}")
if not config["available"]:
    raise RuntimeError(config.get("unavailable_reason") or "H3 图片生成当前不可用")
if config["prices"].get(RESOLUTION) is None:
    raise RuntimeError(f"H3 的 {RESOLUTION} 档位暂未开放")
 
# 保存此键；若创建请求超时，应使用同一键和相同请求重试。
idempotency_key = str(uuid.uuid4())
print("Idempotency-Key:", idempotency_key)
result = api("POST", "/image/v1/tasks", {
    "model": MODEL,
    "prompt": "山谷中的木屋，清晨薄雾，远山层叠，电影感光影",
    "aspect_ratio": "16:9",
    "resolution": RESOLUTION,
}, idempotency_key=idempotency_key)
task_id = result["task_id"]
print("task_id:", task_id)
 
deadline = time.monotonic() + 1200
while time.monotonic() < deadline:
    task = api("GET", f"/image/v1/tasks/{task_id}")["task"]
    if task["status"] == "succeeded":
        # 下载公共结果地址时无需携带模型 API Key。
        with urlopen(task["output_url"], timeout=60) as image:
            Path("h3-image.png").write_bytes(image.read())
        print("已保存 h3-image.png，模型：", task["input"]["model"])
        print("消耗积分：", task["point_cost"])
        break
    if task["status"] in {"failed", "cancelled", "blocked"}:
        raise RuntimeError(task.get("error_message") or task["status"])
    time.sleep(3)
else:
    raise TimeoutError(f"轮询超时，可继续查询任务 {task_id}")