Authorization: Bearer YOUR_API_KEY

POST /v1/images/generations

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

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

GET /v1/tasks/{task_id}

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE_OFFICIAL",
    "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-official",
    "prompt": "生成一张高级感杂志封面人像，主体是年轻女性，柔和棚拍光线，画面干净，皮肤细节自然",
    "size": "4:5",
    "resolution": "2k",
    "quality": "high",
    "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-official' \
  --form 'prompt=保留主体姿态与服装，改为高级棚拍封面风格，增强反射与层次感' \
  --form 'image=@/path/to/reference-1.png' \
  --form 'size=4:5' \
  --form 'quality=high' \
  --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-official",
    "prompt": "生成一张高质感品牌海报，主体是现代感香水瓶，玻璃与金属材质细节清晰",
    "n": 1,
    "size": "1:1",
    "resolution": "2k",
    "quality": "high",
    "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-official",
    "prompt": "生成一张高级感杂志封面人像，主体是年轻女性，柔和棚拍光线，画面干净，皮肤细节自然",
    "n": 1,
    "size": "4:5",
    "resolution": "2k",
    "quality": "high",
    "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-official",
    "prompt": "保留主体与视角，改为杂志封面式高级棚拍，增强反射与层次感",
    "n": 1,
    "size": "4:5",
    "resolution": "4k",
    "quality": "high",
    "images": [
      "https://example.com/reference-1.png"
    ],
    "response_format": "url"
  }'