图片生成模型

POST /v1/images/generations — 创建图片生成任务
GET /v1/images/generations/{task_id} — 查询单个任务
GET /v1/images/generations — 查询任务列表

POST {CMR_BASE_URL}/v1/images/generations
GET  {CMR_BASE_URL}/v1/images/generations/{task_id}
GET  {CMR_BASE_URL}/v1/images/generations

# ① 创建任务（窗口内完成时响应已含 result）
curl --request POST "${CMR_BASE_URL}/v1/images/generations" \\
  --header "Authorization: Bearer ${CMR_API_KEY}" \\
  --header "Content-Type: application/json" \\
  --data '{
    "model": "cmr-image",
    "contents": [
      { "type": "text", "text": "一只戴墨镜的柴犬坐在冲浪板上，写实风格" }
    ],
    "size": "1536x1024"
  }'
# → {"id":"imgtask_01JQ8ZC3M9X7YB2KDVF6AHRW5B","status":"in_progress","error":null}

# ② 轮询任务状态，直到 status 为 completed、failed 或 expired
curl --request GET "${CMR_BASE_URL}/v1/images/generations/imgtask_01JQ8ZC3M9X7YB2KDVF6AHRW5B" \\
  --header "Authorization: Bearer ${CMR_API_KEY}"

# ③ status=completed 后，从 result.data[0].url 或 result.data[0].b64_json 取图

import os
import time
import requests

base_url = os.environ["CMR_BASE_URL"]
headers = {
    "Authorization": f"Bearer {os.environ['CMR_API_KEY']}",
    "Content-Type": "application/json",
}

# ① 创建任务
resp = requests.post(
    f"{base_url}/v1/images/generations",
    headers=headers,
    json={
        "model": "cmr-image",
        "contents": [
            {"type": "text", "text": "一只戴墨镜的柴犬坐在冲浪板上，写实风格"}
        ],
        "size": "1536x1024",
    },
    timeout=120,
)
resp.raise_for_status()
task = resp.json()

# ② 未终态时轮询（建议间隔 2 秒以上）
while task["status"] in ("queued", "in_progress"):
    time.sleep(2)
    task = requests.get(
        f"{base_url}/v1/images/generations/{task['id']}",
        headers=headers,
        timeout=30,
    ).json()

# ③ 获取结果
if task["status"] == "completed":
    image = task["result"]["data"][0]
    print(image.get("url") or image.get("b64_json"))
else:
    print(task["error"])

POST /v1/images/generations

{
  "model": "cmr-image",
  "contents": [
    { "type": "text", "text": "一只戴墨镜的柴犬坐在冲浪板上，写实风格" }
  ],
  "size": "1536x1024"
}

{
  "model": "cmr-image",
  "contents": [
    { "type": "text", "text": "把沙发换成深绿色天鹅绒，保持光照不变" },
    { "type": "image", "role": "reference", "url": "https://example.com/room.jpg", "id": "room" }
  ],
  "size": "1536x1024"
}

{
  "id": "imgtask_01JQ8ZC3M9X7YB2KDVF6AHRW5B",
  "object": "image",
  "status": "in_progress",
  "model": "cmr-image",
  "created_at": 1789000000,
  "completed_at": null,
  "expires_at": 1789086400,
  "error": null
}

{
  "model": "cmr-image",
  "contents": [
    { "type": "text", "text": "同一只柴犬的四个角度" }
  ],
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": { "max_images": 4 }
}

GET /v1/images/generations/{task_id}

{
  "id": "imgtask_01JQ8ZC3M9X7YB2KDVF6AHRW4T",
  "object": "image",
  "status": "completed",
  "created_at": 1789000000,
  "completed_at": 1789000012,
  "expires_at": 1789086400,
  "model": "cmr-image",
  "error": null,
  "result": {
    "created": 1789000012,
    "data": [
      {
        "index": 0,
        "url": "https://upstream.example.com/out.png",
        "b64_json": null,
        "size": "1536x1024",
        "output_format": "png"
      }
    ],
    "errors": [],
    "usage": {
      "input_tokens": 18,
      "output_tokens": 4160,
      "total_tokens": 4178,
      "input_images": 0,
      "generated_images": 1,
      "resolution": "1.5k"
    }
  }
}

GET /v1/images/generations

{
  "error": {
    "message": "size and resolution are mutually exclusive",
    "type": "invalid_request_error",
    "param": "size",
    "code": "invalid_parameter"
  }
}