MiniMax H3 Image API
เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างภาพจากข้อความและแก้ไขภาพ MiniMax H3 Image
รุ่นของโมเดล {#}
API นี้รองรับโมเดลสองรุ่น:
ตารางเปรียบเทียบโดยย่อ
อัตราส่วนภาพที่รองรับ
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
ระบุอัตราส่วนเป็นค่าตัวเลข width และ height แยกกัน ไม่ใช่ขนาดเป็นพิกเซล หากละเว้นทั้งสองค่า อัตราส่วนจะมีค่าเริ่มต้นเป็น 1:1 มิฉะนั้น ให้ระบุทั้งสองค่าโดยใช้คู่จำนวนเต็มที่รองรับคู่ใดคู่หนึ่ง
MiniMax H3 Image (การสร้างภาพจากข้อความ)
เอนด์พอยต์
POST /api/v1/image/task
การยืนยันตัวตน
Authorization: Bearer YOUR_API_KEY
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
หมายเหตุ: อัตราส่วน width:height ต้องเป็นหนึ่งใน 15 อัตราส่วนที่รองรับซึ่งระบุไว้ข้างต้น
ตัวอย่างคำขอ
javascript
MiniMax H3 Image Edit (การแก้ไขภาพ)
เอนด์พอยต์
POST /api/v1/image/task
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
หมายเหตุ: อัตราส่วน width:height ต้องเป็นหนึ่งใน 15 อัตราส่วนที่รองรับซึ่งระบุไว้ข้างต้น
ตัวอย่างคำขอ
javascript
ตัวอย่างการแก้ไขภาพเดียว
javascript
ตัวอย่างการประกอบภาพหลายภาพ
javascript
รูปแบบการตอบกลับ
การตอบกลับเริ่มต้น
json
การตอบกลับจากการโพล
โพล GET /api/v1/image/{task_id} เพื่อตรวจสอบสถานะ การตอบกลับจากการโพลที่สำเร็จจะให้ URL ของภาพที่สร้างไว้ใน data.task_result.images[].url
ค่าสถานะ
submitted: รับงานแล้วprocessing: กำลังสร้างภาพsucceed: สร้างภาพเสร็จสมบูรณ์failed: สร้างภาพไม่สำเร็จ
แนวทางปฏิบัติที่แนะนำ
- พรอมต์ที่ละเอียด: อธิบายตัวแบบ แสง และองค์ประกอบภาพ โดยให้พรอมต์มีความยาวไม่เกิน 5000 อักขระ
- การเลือกความละเอียด: ส่งค่า
1k,2kหรือ4kอย่างชัดเจนในทุกคำขอ - อัตราส่วนภาพ: ใช้ค่าอัตราส่วนที่จับคู่กันสำหรับ
widthและheightหรือละเว้นทั้งสองค่าเพื่อใช้1:1 - คุณภาพการแก้ไขภาพ: ให้ภาพอ้างอิง 1-16 ภาพที่ตรงตามข้อกำหนดด้านรูปแบบไฟล์และขนาดที่รองรับ