Qwen-Image 图片生成 API

https://cp.compshare.cn

Authorization: Bearer <YOUR_API_KEY>

GET https://cp.compshare.cn/image/v1/config

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

{
  "available": true,
  "unavailable_reason": "",
  "price_version": "3",
  "prices": {
    "1K": {"base": 6, "per_reference": 2},
    "2K": null
  },
  "moderation_available": true,
  "reference_moderation_available": true,
  "prompt_optimization_available": true,
  "prompt_optimization_default_enabled": false
}

单张积分费用 = 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: image-text-001' \
  -d '{
    "prompt": "一只戴着宇航头盔的猫，漂浮在月球表面，地球在背景中升起，电影感光影",
    "optimize_prompt": true,
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

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

{"task_id": "019xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

GET https://cp.compshare.cn/image/v1/tasks/{task_id}

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

{
  "task": {
    "task_id": "019xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "status": "succeeded",
    "can_cancel": false,
    "input": {
      "prompt": "一只戴着宇航头盔的猫，漂浮在月球表面",
      "optimize_prompt": true,
      "aspect_ratio": "16:9",
      "resolution": "1K",
      "width": 1376,
      "height": 768,
      "output_format": "png",
      "reference_images": []
    },
    "effective_prompt": "一只戴着宇航头盔的猫，漂浮在月球表面，地球在背景中缓缓升起，电影感光影，细节丰富",
    "prompt_optimization": {"id": "<OPTIMIZATION_ID>", "status": "succeeded"},
    "point_cost": 6,
    "point_status": "consumed",
    "output_url": "https://example.com/generated/output.png",
    "output_size": 3200000,
    "created_at": 1789459200,
    "started_at": 1789459203,
    "finished_at": 1789459250
  }
}

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

curl 'https://cp.compshare.cn/image/v1/tasks?offset=0&limit=20&statuses=queued&statuses=generating' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

{"items": [], "total": 0, "status_counts": {"succeeded": 3}}

POST https://cp.compshare.cn/image/v1/tasks/{task_id}/cancel

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

{"task_id": "019xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "cancelled": true}

DELETE https://cp.compshare.cn/image/v1/tasks/{task_id}

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

{"task_id": "019xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "deleted": true}

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

curl -X POST 'https://cp.compshare.cn/image/v1/upload_urls' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"file_name":"reference.png","content_type":"image/png","file_size":240000}'

{
  "object_key": "ai-image/production/uploads/<OWNER>/<UPLOAD_ID>/staging/ai-image-xxxx.png",
  "upload_url": "https://example.com/upload/ai-image-xxxx.png",
  "authorization": "UCloud <PUBLIC_KEY>:<SIGNATURE>",
  "bucket": "<BUCKET>",
  "region": "<REGION>"
}

curl --fail-with-body -X PUT '<UPLOAD_URL>' \
  -H 'Content-Type: image/png' \
  -H 'Authorization: <AUTHORIZATION>' \
  -H 'bucket: <BUCKET>' \
  -H 'ufile_indicated_region: <REGION>' \
  --data-binary '@reference.png'

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

curl -X POST 'https://cp.compshare.cn/image/v1/assets' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "object_key": "<OBJECT_KEY>",
    "file_name": "reference.png",
    "content_type": "image/png",
    "file_size": 240000,
    "width": 1024,
    "height": 768
  }'

{
  "reference": {
    "asset_id": "<ASSET_ID>",
    "url": "https://example.com/reference/reference.png",
    "name": "reference.png",
    "width": 1024,
    "height": 768,
    "size": 240000
  }
}

GET https://cp.compshare.cn/minimax/v2/query/point_packages

curl 'https://cp.compshare.cn/minimax/v2/query/point_packages' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

{
  "type": "error",
  "error": {
    "type": "bad_request_error",
    "message": "Idempotency-Key is required and must contain 1 to 128 characters",
    "http_code": "400"
  },
  "request_id": "<REQUEST_ID>"
}

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"]
 
 
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", "/image/v1/config")
if not config["available"]:
    raise RuntimeError(config.get("unavailable_reason") or "图片生成当前不可用")
price = (config["prices"].get("1K") or {}).get("base")
if price is None:
    raise RuntimeError("1K 档位价格未配置")
 
# 保存此键；若创建请求超时，应使用同一键和相同请求重试。
idempotency_key = str(uuid.uuid4())
print("Idempotency-Key:", idempotency_key)
result = api("POST", "/image/v1/tasks", {
    "prompt": "一只戴着宇航头盔的猫，漂浮在月球表面，地球在背景中升起，电影感光影",
    "optimize_prompt": True,
    "aspect_ratio": "16:9",
    "resolution": "1K",
}, 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("image.png").write_bytes(image.read())
        print("已保存 image.png，消耗积分：", 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}")