Authorization: Bearer YOUR_API_KEY

POST /v1/images/generations

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "submitted",
    "model": "gpt-image-2"
  }
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、size、resolution 或 images 是否符合当前模型要求"
  }
}

GET /v1/tasks/{task_id}

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "succeeded",
    "works": [
      {
        "asset_url": "https://example.com/result/image-01.png"
      }
    ]
  }
}

POST /v1/images/generations
Content-Type: application/json

curl --request POST \
  --url https://your-domain/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "生成一张高级感产品海报，主体是一瓶透明玻璃香水，棚拍光线干净，金属高光自然",
    "size": "3:4",
    "resolution": "2k",
    "response_format": "url"
  }'

POST /v1/images/edits
Content-Type: multipart/form-data

curl --request POST \
  --url https://your-domain/v1/images/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model=gpt-image-2' \
  --form 'prompt=保留主体姿态与服装，改为清晨自然光人像摄影，背景为白色纱帘' \
  --form 'image=@/path/to/reference-1.png' \
  --form 'size=3:4' \
  --form 'response_format=url'

{
  "created": 1776748674,
  "data": [
    {
      "url": "https://example.com/result/image-01.png",
      "revised_prompt": "生成一张高级感产品海报，主体是一瓶透明玻璃香水，棚拍光线干净，金属高光自然"
    }
  ]
}

curl --request POST \
  --url https://your-domain/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "生成一张高转化电商主图，主体是一瓶橙花香水，白底干净构图，玻璃高光自然，商业摄影风格",
    "n": 1,
    "size": "1:1",
    "resolution": "2k",
    "response_format": "url"
  }'

curl --request POST \
  --url https://your-domain/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "保留人物主体姿态与服装，改为清晨自然光人像摄影，肤色真实，背景为白色纱帘",
    "n": 1,
    "size": "3:4",
    "resolution": "1k",
    "images": [
      "https://example.com/reference-1.jpg"
    ],
    "response_format": "url"
  }'

curl --request POST \
  --url https://your-domain/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "把两张参考图融合为一张电影海报，保留人物主体与车辆造型，统一成深夜霓虹街头氛围",
    "n": 1,
    "size": "16:9",
    "resolution": "2k",
    "images": [
      "https://example.com/reference-1.jpg",
      "https://example.com/reference-2.jpg"
    ],
    "response_format": "url"
  }'