เอกสาร API ของ GPT Image Hub

เอนด์พอยต์ v1 ทั้งหมด ยกเว้นการแสดงรายการโมเดล ต้องใช้คีย์ API ในส่วนหัว Authorization คีย์ดิบจะแสดงเพียงครั้งเดียวตอนสร้าง และเซิร์ฟเวอร์จะเก็บเฉพาะค่าแฮชเท่านั้น

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

เอนด์พอยต์ models จะส่งคืน ID โมเดล ผู้ให้บริการ อัตราส่วนภาพที่รองรับ คุณภาพที่รองรับ ขีดจำกัดรูปภาพอ้างอิง และเครดิตต่อรูปภาพ

curl https://www.gptimagehub.com/api/v1/models

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

เอนด์พอยต์ credits จะส่งคืนยอดคงเหลือ ประเภทบัญชี และการหมดอายุของเครดิตที่กำลังจะมาถึงสำหรับผู้ใช้ที่เป็นเจ้าของคีย์ API

curl https://www.gptimagehub.com/api/v1/credits \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

โดยค่าเริ่มต้น เอนด์พอยต์การสร้างภาพจะรอจนกว่าจะเสร็จสิ้น ตั้งค่า async เป็น true เพื่อรับ generation id ทันที แล้ว poll ที่ /api/v1/generations/:generationId เพื่อดูผลลัพธ์ ระบบจะหักเครดิตก่อนที่ผู้ให้บริการจะสร้างภาพ และคืนเครดิตให้อัตโนมัติเมื่อผู้ให้บริการล้มเหลวหรือส่งคืนภาพน้อยกว่าที่ขอ

คำขอ JSON

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo of a transparent perfume bottle on black marble",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

งานแบบอะซิงโครนัส

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-hero-image" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1,
    "async": true
  }'

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "queued",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "created_at": "2026-04-30T08:00:00.000Z",
  "images": [],
  "usage": {
    "credits": 0,
    "credits_requested": 7
  },
  "poll_url": "https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id"
}

คำขอพร้อมภาพอ้างอิง

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "model=gpt-image-2" \
  -F "prompt=Use the reference image and render it as a premium studio product shot" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1" \
  -F "reference_image=@./reference.png"

การตอบสนอง

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "succeeded",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "images": [
    {
      "id": "clx_image_id",
      "object": "image",
      "url": "https://cdn.example.com/generations/user/image.png",
      "created_at": "2026-04-30T08:00:00.000Z"
    }
  ],
  "usage": {
    "credits": 7
  },
  "balance": {
    "credits": 113,
    "account_type": "PRO",
    "next_expiration": null
  }
}

ใช้ id ที่ได้จากเอนด์พอยต์การสร้างเพื่อดึงบันทึกและ URL ของรูปภาพที่จัดเก็บไว้ คีย์ API สามารถอ่านได้เฉพาะการสร้างที่เป็นของผู้ใช้คนเดียวกันเท่านั้น

curl https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "error": {
    "message": "Invalid request body",
    "code": "invalidRequest"
  }
}

• การสร้างแบบ synchronous สามารถทำงานได้นานสูงสุด 800 วินาทีบน production
• n ต้องอยู่ระหว่าง 1 ถึง 4
• รูปภาพอ้างอิงรองรับ PNG, JPG, JPEG และ WebP ทั้งคำขอรวมถึงรูปภาพอ้างอิงทั้งหมดต้องมีขนาดไม่เกิน 4.5MB (รวมรูปภาพทั้งหมดแล้วต้องไม่เกิน 4MB) หากคำขอมีขนาดใหญ่กว่านี้ แพลตฟอร์มโฮสติ้งจะปฏิเสธด้วยข้อความธรรมดาพร้อมรหัส 413 ก่อนที่จะถึง API ดังนั้นโปรดปรับขนาดหรือบีบอัดรูปภาพก่อน
• จำนวนรูปภาพอ้างอิงสูงสุดถูกกำหนดโดย reference_image_limit ของแต่ละโมเดล
• การจำกัดอัตราการใช้งาน: 60 คำขอสร้างต่อนาทีต่อ API key และ 120 คำขอต่อนาทีต่อ IP address ทุกการตอบกลับจะมีส่วนหัว RateLimit-Limit, RateLimit-Remaining และ RateLimit-Reset แนบมาด้วย ส่วนการตอบกลับ 429 จะมี Retry-After แนบมาด้วยเช่นกัน
• หากต้องการลองสร้างใหม่อย่างปลอดภัย ให้ส่งส่วนหัว Idempotency-Key (ความยาวสูงสุด 120 ตัวอักษร) การส่งคีย์เดิมซ้ำพร้อมกับ API key เดิมจะส่งคืนผลลัพธ์การสร้างเดิมแทนที่จะคิดค่าบริการซ้ำ
• โหมด Async จะส่งคืนรหัส 202 พร้อมกับ poll_url ปัจจุบันยังไม่รองรับ Webhook