GPT Image 2 API reference

# ─── 1. Text-to-image ──────────────────────────────────────
# resolution: "1K" | "2K" | "4K" (optional, default 1K). aspect_ratio: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16.
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A minimalist product shot of a white sneaker on a pastel gradient backdrop, soft studio lighting",
    "aspect_ratio": "1:1",
    "resolution": "2K"
  }'

# Response:
# { "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "pending" } }


# ─── 2. Image editing with a reference URL ─────────────────
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Place this product on a marble kitchen counter with soft morning light",
    "image_url": "https://example.com/product.jpg",
    "aspect_ratio": "3:2"
  }'


# ─── 3. Multi-image fusion (up to 10 reference images) ─────
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Use the model from image 1 wearing the outfit from image 2, studio lighting",
    "image_urls": [
      "https://example.com/model.jpg",
      "https://example.com/outfit.jpg"
    ],
    "aspect_ratio": "2:3"
  }'


# ─── 4. Image editing via base64 ───────────────────────────
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Add a geometric fox logo in the center of the mug",
    "image_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "image_mime_type": "image/png",
    "aspect_ratio": "1:1"
  }'


# ─── 5. Poll task status ───────────────────────────────────
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Success response:
# {
#   "code": 200,
#   "msg": "success",
#   "data": {
#     "taskId": "clxxx...",
#     "state": "completed",
#     "resultUrls": ["https://r2.apimodels.app/images/xxx.png"],
#     "images": [{"url": "https://r2.apimodels.app/images/xxx.png", "width": 2048, "height": 2048}],
#     "costTime": 14320,
#     "completeTime": 1705123465000
#   }
# }


# ─── 6. Webhook callback (optional) ────────────────────────
# Add "callback_url" to the create request and your endpoint
# will receive a POST with the same payload when the task
# completes — useful for production to avoid polling.
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Studio photo of a ceramic mug",
    "aspect_ratio": "1:1",
    "callback_url": "https://your-domain.com/webhook/image"
  }'