การกำหนดค่า OpenAI Images API
การสร้างรูปภาพไม่ใช่ส่วนต่อประสานแชตแบบปกติ แม้ว่าผู้ให้บริการ AI (provider) จะรองรับโมเดลข้อความ แต่ก็ไม่ได้หมายความว่าจะรองรับส่วนต่อประสานรูปภาพของ OpenAI เสมอไป โปรดตรวจสอบกับผู้ให้บริการว่ามีการระบุ 'Images API', 'image generation' หรือโมเดลที่เกี่ยวข้องอย่างชัดเจนหรือไม่ก่อนเริ่มกำหนดค่า
ข้อมูลทางการ การดาวน์โหลดและเอกสารให้อ้างอิงจากเว็บไซต์ทางการเป็นหลัก
ตรวจสอบก่อนว่าผู้ให้บริการรองรับส่วนต่อประสานรูปภาพหรือไม่
| สิ่งที่ต้องตรวจสอบ | วิธีดู | เหตุผล |
|---|---|---|
| ประเภทของส่วนต่อประสาน | ระบบหลังบ้านหรือเอกสารระบุชัดเจนเกี่ยวกับ Images API, การสร้างรูปภาพ, การแก้ไขรูปภาพหรือไม่ | การระบุเพียงว่ารองรับส่วนต่อประสานแชตที่เข้ากันได้กับ OpenAI ไม่ได้แปลว่าส่วนต่อประสานรูปภาพจะใช้งานได้ด้วย |
| สิทธิ์ของโมเดล | รายชื่อโมเดลมีโมเดลรูปภาพหรือไม่ และบัญชีหรือ Key ได้รับสิทธิ์อนุญาตหรือไม่ | โมเดลรูปภาพมักคิดค่าบริการแยกต่างหากและต้องเปิดใช้งานแยกจากโมเดลข้อความ |
| Request Path | ผู้ให้บริการได้ให้ตัวอย่างสำหรับส่วนต่อประสานรูปภาพไว้หรือไม่ | ผู้ให้บริการบางรายทำพร็อกซีเฉพาะส่วนต่อประสานแชตเท่านั้น การส่งคำขอตรงไปยังพาธรูปภาพจะทำให้เกิดข้อผิดพลาด 404 |
| ราคา | รูปภาพจะคิดค่าบริการตามจำนวนชิ้น ขนาด หรือคุณภาพ | ควรทดสอบด้วยจำนวนน้อยๆ ก่อนสร้างจำนวนมาก เพื่อหลีกเลี่ยงค่าใช้จ่ายสูงในคราวเดียว |
ความแตกต่างจากส่วนต่อประสานแชต
| ประเภท | ส่วนต่อประสานทั่วไป | สิ่งที่ต้องเตรียม |
|---|---|---|
| แชตข้อความ | /v1/chat/completions Or Responses | Key, Base URL, ชื่อโมเดล, เนื้อหาข้อความ |
| การสร้างรูปภาพ | /v1/images/generations | Key, โมเดลรูปภาพ, พรอมต์, ขนาด, รูปแบบเอาต์พุต |
| การแก้ไขรูปภาพ | Image editing interface | นอกจากพรอมต์แล้ว คุณยังต้องอัปโหลดรูปภาพต้นฉบับหรือมาสก์ด้วย |
วิธีกรอกฟิลด์ข้อมูล
| รายการกำหนดค่า | วิธีกรอก |
|---|---|
| Endpoint | https://api.openai.com/v1/images/generations |
| Model | ตัวอย่างทางการที่ใช้ได้: <code>gpt-image-2</code>; สำหรับบริการของผู้ให้บริการ (provider) ให้กรอกตามรายชื่อที่ผู้ให้บริการระบุ |
| Prompt | รูปภาพที่คุณต้องการสร้าง |
| Size | ขนาดรูปภาพ |
| Format | URL หรือ base64 |
หากใช้งานผ่านผู้ให้บริการ ให้แทนที่ส่วนโดเมนทางการด้วยที่อยู่ Image API ที่ผู้ให้บริการให้มา หากผู้ให้บริการไม่ได้ระบุว่ารองรับส่วนต่อประสานรูปภาพ อย่าสรุปเอาเองว่าใช้งานได้ ส่วน Base URL จะต้องมี /v1 หรือไม่นั้น ให้ปฏิบัติตามตัวอย่างในระบบหลังบ้าน อย่าคาดเดาเอาเอง
ตัวอย่างคำขอ
ตัวอย่างการสร้างรูปภาพด้วย OpenAI
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'ค่าบริการของส่วนต่อประสานรูปภาพมักแตกต่างจากส่วนต่อประสานข้อความ โปรดตรวจสอบราคาก่อนเริ่มสร้างภาพจำนวนมาก
| ข้อผิดพลาด | สาเหตุทั่วไป | วิธีแก้ไข |
|---|---|---|
| 404 / endpoint not found | ผู้ให้บริการไม่มีพร็อกซีสำหรับส่วนต่อประสานรูปภาพ หรือมีเครื่องหมายทับ /v1 เกินหรือขาดไปในพาธ | ไปที่ระบบหลังบ้านเพื่อหาตัวอย่างส่วนต่อประสานรูปภาพโดยเฉพาะ อย่าใช้ส่วนต่อประสานแชตโดยตรง |
| model not found | ชื่อโมเดลรูปภาพไม่อยู่ในรายชื่อของผู้ให้บริการรายปัจจุบัน | คัดลอก Model ID หรือชื่อโมเดลรูปภาพเดิมที่ถูกต้อง ไม่ใช่โมเดลข้อความ |
| unsupported content type | ส่วนต่อประสานการแก้ไขรูปภาพจำเป็นต้องอัปโหลดไฟล์ คุณไม่สามารถส่งเพียงแค่ JSON ได้ | ยืนยันก่อนว่าคุณกำลังเรียกใช้ส่วนต่อประสานการสร้างภาพ (generation) หรือส่วนต่อประสานการแก้ไข (editing) |