สร้างภาพ GPT-Image-2

gpt-image-2 รองรับสร้างภาพและแก้ภาพอ้างอิงสำหรับภาพสินค้า ร่างโปสเตอร์ ภาพประกอบ สื่อโซเชียล ภาพความละเอียดสูง การถ่ายทอดสไตล์ และรวมภาพอ้างอิงหลายภาพ

POST https://api.apihop.ai/openai/v1/images/generations

การยืนยันตัวตน

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

เริ่มต้นอย่างรวดเร็ว

{
  "model": "gpt-image-2",
  "prompt": "A minimal black wireless earbud product poster on a white background, clean studio lighting, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "low"
}

ขอบเขตเปรียบเทียบราคา

ระดับภาพ 1K / 2K / 4K ที่ API Hop เผยแพร่เป็น*ราคาขายของ API Hop* ไม่ใช่ราคาคงที่ต่อภาพทางการของ OpenAI เอกสารราคา OpenAI อธิบายการคิดโทเคนภาพ/ข้อความและระดับประมวลผล ต้นทุนจริงขึ้นกับขนาด คุณภาพ อินพุตอ้างอิง และเอาต์พุต การเปรียบเทียบเพียงเพราะทั้งคู่ระบุ 1k หรือ 2k ไม่ใช่การคำนวณส่วนลดบนเงื่อนไขเดียวกัน

เพื่อหลีกเลี่ยงคำกล่าวอ้างประหยัดที่ไม่มีหลักฐาน จึงซ่อนราคาอ้างอิง USD per image จากผู้ให้บริการรวมแบบเดิมและป้ายส่วนลดของ GPT Image 2 โดยตั้งใจ ราคา API Hop ยังแสดงและข้อกำหนดคิดค่าบริการไม่เปลี่ยน เพื่อเปรียบเทียบภายหน้าอย่างมีหลักฐาน บันทึกโมเดล เอนด์พอยต์ คุณภาพภาพ ขนาด เงื่อนไขอินพุต URL แหล่งทางการ และวันที่ตรวจอ้างอิงให้ตรง ตรวจราคาที่มีผลกับบัญชีก่อนเรียกแบบเสียเงิน

เนื้อหาคำขอ

ภาพอ้างอิงและการแก้ไข

การแก้ภาพอ้างอิงใช้เอนด์พอยต์ JSON เดียวกัน เพิ่ม image_urls และอธิบายสิ่งที่จะคงและเปลี่ยนใน prompt:

{
  "model": "gpt-image-2",
  "prompt": "Keep the product unchanged, replace the background with a dark blue studio, and add soft rim lighting",
  "image_urls": [
    "https://example.com/product.png"
  ],
  "size": "1:1",
  "resolution": "2k"
}

ภาพอ้างอิงหลายภาพให้ตัวแบบ องค์ประกอบ หรือสไตล์ภาพได้:

{
  "model": "gpt-image-2",
  "prompt": "Use the product from the first image and the composition from the second image to create a clean ecommerce hero image",
  "image_urls": [
    "https://example.com/product.png",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ],
  "size": "4:3",
  "resolution": "2k"
}

ขอบเขตข้อกำหนดสาธารณะปัจจุบัน:

• รองรับแก้ทั้งภาพ ถ่ายทอดสไตล์ และรวมหลายภาพอ้างอิงผ่าน image_urls
• ไม่มีเส้นทาง POST https://api.apihop.ai/openai/v1/images/edits แยก
• ไม่รับอัปโหลด multipart/form-data แปลงภาพในเครื่องเป็น base64 data URI หรืออัปโหลดเป็น URL ที่เข้าถึงได้ก่อน
• ไม่รองรับเติมภาพด้วยมาสก์ การส่ง mask, mask_url หรือ maskUrl ส่ง 400 ก่อนกันยอด

ตัวอย่างคำขอ

ภาพสินค้า 1:1

{
  "model": "gpt-image-2",
  "prompt": "A transparent glass cup on a light gray background, commercial product photography, soft shadow, no text",
  "n": 1,
  "size": "1024x1024",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png"
}

โปสเตอร์ 16:9

{
  "model": "gpt-image-2",
  "prompt": "A futuristic city night poster with neon lights, wet streets, cinematic composition, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "medium",
  "output_format": "jpeg"
}

วิธีส่งผลลัพธ์

เอนด์พอยต์ที่เข้ากันได้กับ OpenAI นี้ไม่ส่งการตอบกลับรับงานที่มี data.jobId ก่อนเพื่อตรวจภายหลัง:

• เมื่อ stream: false คำขอ HTTP ปัจจุบันรอจนเสร็จและส่ง URL ภาพในการตอบกลับ JSON
• เมื่อ stream: true การเชื่อมต่อ SSE ปัจจุบันเปิดจนถึง image_generation.completed และ [DONE]

อย่าใช้ GET https://api.apihop.ai/v1/jobs/{id} ดึงผลจากเอนด์พอยต์นี้ ใช้อ่านงานอะซิงโครนัส เฉพาะเมื่อเอนด์พอยต์สร้างอะซิงโครนัสส่ง jobId ชัดเจน

การตอบกลับไม่สตรีม

การตอบกลับมี URL ภาพ รวม usage เมื่อเส้นทางต้นทางให้ข้อมูลวัดการใช้งาน

{
  "created": 1777270000,
  "data": [
    {
      "url": "https://image.example.com/generated/123456789012345678/0.png"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 1234,
    "total_tokens": 1254
  }
}

การตอบกลับสตรีม

event: image_generation.completed
data: {"type":"image_generation.completed","data":[{"index":0,"url":"https://image.example.com/generated/123456789012345678/0.png"}],"usage":{"input_tokens":20,"output_tokens":1234,"total_tokens":1254}}

data: [DONE]

ขนาดอ้างอิง

การตอบกลับข้อผิดพลาด

ดูรหัสข้อผิดพลาดและการแก้ปัญหา สำหรับรหัสอ้างอิงทั้งหมด ความต่างโปรโตคอล และขั้นตอนวินิจฉัย

{
  "code": 10000,
  "message": "prompt is required",
  "type": "api_error"
}

ข้อผิดพลาดที่พบบ่อย:

• 400: ขาดพารามิเตอร์บังคับหรือชุดพารามิเตอร์ไม่รองรับ
• 401: ยืนยันตัวตนล้มเหลวหรือคีย์ API ไม่ถูกต้อง
• 402: ยอดไม่พอ
• 404: ไม่มีโมเดลหรือยังไม่เปิดใช้
• 429: เกินขีดจำกัดอัตรา
• 5xx: บริการไม่พร้อมชั่วคราวหรือสร้างภาพล้มเหลว