ภาพนูน API

รูปภาพที่จะแปลงเป็นภาพนูน โดยเป็น URL สาธารณะหรือ data URI (data:image/png;base64,...)

รูปภาพต้องเป็นไฟล์ JPG, JPEG, PNG หรือ WebP ขนาดไม่เกิน 20 MB และมีขนาดอย่างน้อย 32 × 32 พิกเซล ด้านที่ยาวกว่าต้องมีขนาดไม่เกินประมาณ 16 เท่าของด้านที่สั้นกว่า รูปภาพอื่นนอกเหนือจากนี้จะได้รับ 400 Meshy จะเติมพื้นที่โปร่งใสด้วยสีดำก่อนสร้างภาพนูน

สไตล์ของภาพนูน ซึ่งกำหนดรูปร่างของแผนที่ความลึกและตั้งค่า carving_depth_mm เริ่มต้น

ค่าที่ใช้ได้:

• high: แกะสลักลึกกว่า เหมาะสำหรับชิ้นงานที่พิมพ์ 3 มิติ
• low: แกะสลักตื้น เหมาะสำหรับการแกะสลักด้วยเลเซอร์ การแกะสลักด้วย CNC และแผ่นป้ายบาง

การส่ง null หรือ "" มีผลเหมือนกับการไม่ใส่พารามิเตอร์นี้ ค่าอื่นนอกเหนือจากนี้จะได้รับ 400

กำหนดว่าจะสร้างโมเดลภาพนูนหรือไม่ ตั้งค่าเป็น false สำหรับงานที่ต้องการเฉพาะแผนที่ความลึกเท่านั้น โดยไม่มีโมเดลและไม่มีภาพตัวอย่าง Meshy ยังคงตรวจสอบพารามิเตอร์ขนาด การแกะสลัก ฐาน การโค้งงอ และความละเอียด แต่จะไม่นำไปใช้งาน และไม่มีผลต่อจำนวนเครดิตที่ใช้

ความยาวของด้านที่ยาวกว่าของรูปภาพบนโมเดล วัดในสภาพแบนราบก่อนการโค้งงอใด ๆ มีค่าตั้งแต่ 20 ถึง 250 มิลลิเมตร เมื่อใช้ remove_base โมเดลอาจมีขนาดเล็กลงได้

กำหนดว่าวัตถุหลักจะนูนขึ้นจากแผ่นหรือถูกแกะเข้าไปในแผ่น

ค่าที่ใช้ได้:

• emboss: ส่วนที่อยู่ใกล้กว่าของรูปภาพจะนูนขึ้นมา
• engrave: ความลึกจะกลับด้าน ทำให้ส่วนที่อยู่ใกล้กว่าถูกแกะเข้าไป

แผนที่ความลึกจะเหมือนกันในทั้งสองโหมด

ความลึกในการแกะสลักภาพนูน มีค่าตั้งแต่ 0 ถึง 60 มิลลิเมตร เมื่อตั้งค่า remove_base เป็น true การตั้งค่าเป็น 0 จะทำให้ได้โมเดลที่ว่างเปล่า งานยังคงสำเร็จและเสียค่าใช้จ่าย 20 เครดิต และไฟล์ GLB กับ STL จะไม่มีจีออเมทรี

กำหนดว่าจะตัดพื้นหลังออกและไม่สร้างแผ่นฐานหรือไม่ เมื่อตั้งค่าเป็น true พารามิเตอร์ removal_threshold จะกำหนดว่าอะไรนับเป็นพื้นหลัง Meshy จะตรวจสอบ removal_threshold ไม่ว่าจะตั้งค่าแบบใดก็ตาม

ความหนาของแผ่นฐาน มีค่าตั้งแต่ 0.1 ถึง 10 มิลลิเมตร เมื่อ remove_base เป็น true ให้ไม่ใส่พารามิเตอร์นี้หรือส่งค่าเป็น 0

กำหนดว่าจะโค้งงอภาพนูนหรือไม่ และโค้งไปทางใด เมื่อไม่ใช่ off พารามิเตอร์ bend_axis และ bend_angle จะกำหนดรูปร่างของการโค้งงอ Meshy จะตรวจสอบค่าเหล่านี้ไม่ว่าจะตั้งค่าแบบใดก็ตาม

ค่าที่ใช้ได้:

• off: ภาพนูนแบบแบนราบ
• convex: ด้านหน้านูนออก
• concave: ด้านหน้าโค้งเข้า

จำนวนจุดของเมชตามแนวด้านที่ยาวกว่าของรูปภาพ มีค่าตั้งแต่ 512 ถึง 2048 ค่าที่สูงกว่าจะรักษารายละเอียดได้ดีกว่าแต่ทำให้ไฟล์มีขนาดใหญ่ขึ้น ที่ค่าเริ่มต้น 1024 ไฟล์ GLB จะมีขนาดประมาณ 40 ถึง 50 MB และไฟล์ STL จะมีขนาดประมาณ 80 ถึง 105 MB รูปภาพทรงสี่เหลี่ยมจัตุรัสจะให้ขนาดที่ใหญ่กว่า ที่ 2048 ขนาดไฟล์จะอยู่ที่ประมาณ 150 MB และ 300 MB การโค้งงอจะทำให้ไฟล์มีขนาดใหญ่ขึ้น โดยไฟล์ STL อาจมีขนาดถึงประมาณ 800 MB ที่ 2048

คำขอไม่สามารถดำเนินการได้ ข้อความแสดงข้อผิดพลาดจะระบุปัญหาที่พบ ตัวอย่างเช่น:

• พารามิเตอร์ที่ขาดหายไป: ไม่ได้ส่ง image_url
• พารามิเตอร์ไม่ถูกต้อง: พารามิเตอร์มีประเภทไม่ถูกต้อง อยู่นอกช่วงที่กำหนด หรือไม่ใช่หนึ่งในค่าที่ใช้ได้ ตัวอย่างเช่น variant ไม่ใช่ high หรือ low หรือ mesh_resolution ไม่ใช่จำนวนเต็มตั้งแต่ 512 ถึง 2048
• ความหนาของฐาน: base_thickness_mm ไม่ใช่ 0 เมื่อตั้งค่า remove_base เป็น true หรือต่ำกว่า 0.1 เมื่อไม่ได้ตั้งค่า
• URL ที่ไม่สามารถเข้าถึงได้: Meshy ไม่สามารถดาวน์โหลดรูปภาพจาก image_url ได้ เช่น เนื่องจาก URL ส่งคืน 404 หรือหมดเวลา
• รูปภาพไม่ถูกต้อง: รูปภาพไม่ใช่ไฟล์ JPG, JPEG, PNG หรือ WebP มีขนาดเกิน 20 MB มีขนาดเล็กกว่า 32 × 32 พิกเซล มีจำนวนพิกเซลมากเกินไป หรือไม่สามารถอ่านได้
• อัตราส่วนภาพที่สุดโต่ง: ด้านที่ยาวกว่าของรูปภาพมีขนาดมากกว่าประมาณ 16 เท่าของด้านที่สั้นกว่า

แก้ไขคำขอ แล้วส่งอีกครั้ง Meshy จะไม่เรียกเก็บค่าใช้จ่ายสำหรับคำขอนี้ ดู ข้อผิดพลาด

ไม่มี API คีย์หรือ API คีย์ไม่ถูกต้อง ตรวจสอบส่วนหัว Authorization

ตัวอย่างเช่น:

• เครดิตไม่เพียงพอ: บัญชีมีเครดิตไม่เพียงพอสำหรับงานนี้ หรือบัญชีถึงขีดจำกัดเครดิตแล้ว ตรวจสอบยอดคงเหลือเครดิตของคุณ แล้วลองอีกครั้ง
• แผนฟรี: การสร้างงานต้องใช้แผนแบบเสียเงิน อัปเกรดแผนของคุณในการตั้งค่าการสมัครสมาชิก แล้วลองอีกครั้ง

การตรวจสอบเนื้อหา (moderation) บล็อกรูปภาพนี้ Meshy จะไม่เรียกเก็บค่าใช้จ่ายสำหรับคำขอนี้ ส่งรูปภาพอื่นแทน

ถึงขีดจำกัดอย่างใดอย่างหนึ่งต่อไปนี้:

• คุณส่งคำขอมากเกินไป รอสักครู่แล้วลองอีกครั้ง ดู ขีดจำกัดอัตรา
• งานของคุณอยู่ในคิวหรือกำลังทำงานมากเกินไป รอให้บางงานเสร็จสิ้นก่อน แล้วลองอีกครั้ง
• หากใช้แผนแบบไม่จำกัดแต่ไม่มีเครดิตเหลืออยู่ คุณถึงจำนวนงานสูงสุดที่สามารถทำงานได้โดยไม่ใช้เครดิตแล้ว รอให้งานเสร็จสิ้น หรือเพิ่มเครดิต

รหัสงาน (task ID) จากการตอบกลับของการสร้าง

ID ของงานที่ต้องการลบ

หมายเลขหน้าที่ต้องการคืนค่า เริ่มต้นที่และมีค่าเริ่มต้นเป็น 1

จำนวนงานต่อหน้า สูงสุด 100 ค่าเริ่มต้นคือ 10 Meshy จะถือว่าค่าตั้งแต่ 101 ถึง 255 เป็น 100 และหากค่าสูงกว่านั้นจะคืนค่า 400

ลำดับการเรียง

ค่าที่ใช้ได้:

• +created_at: เก่าสุดก่อน
• -created_at: ใหม่สุดก่อน

ID ของงานจากการตอบกลับตอนสร้างงาน

รหัสของทาสก์ ให้ถือว่าเป็นสตริงที่ไม่มีความหมายตายตัว และอย่าอ้างอิงกับรูปแบบของมัน

ประเภทของทาสก์ ซึ่งจะเป็น relief เสมอ

URL สำหรับดาวน์โหลดโมเดลภาพนูน ไฟล์อาจมีขนาดใหญ่ mesh_resolution แสดงขนาดโดยทั่วไป

URL สำหรับดาวน์โหลด depth map แบบสเกลสีเทา 16 บิต ซึ่งเป็นต้นกำเนิดของภาพนูนนี้ พิกเซลที่สว่างกว่าหมายถึงตำแหน่งที่สูงกว่า ค่าต่าง ๆ เป็นความสูงสัมพัทธ์ ไม่ใช่หน่วยมิลลิเมตร ซอฟต์แวร์แกะสลักด้วยเลเซอร์และ CNC สามารถใช้ไฟล์นี้เป็น height map ได้ ไฟล์มีขนาดประมาณ 1 ถึง 2 MB และจะว่างเปล่าหากไม่มี

URL สำหรับดาวน์โหลดภาพตัวอย่างของโมเดลภาพนูน จะว่างเปล่าหากไม่มีการเรนเดอร์ภาพ รวมถึงกรณีที่เป็นทาสก์ที่สร้างเฉพาะ depth map

ความคืบหน้าของทาสก์ เป็นเปอร์เซ็นต์ โดยจะเป็น 0 จนกว่าทาสก์จะเริ่มทำงาน และเป็น 100 เมื่อทาสก์สำเร็จ

สถานะของทาสก์ ซึ่งเป็นหนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED หรือ FAILED

จำนวนทาสก์ที่อยู่ก่อนหน้าทาสก์นี้ในคิว ฟิลด์นี้จะถูกละไว้เมื่อค่าเป็น 0 ดังนั้นจะปรากฏเฉพาะตอนที่มีทาสก์อื่นอยู่ก่อนหน้าทาสก์นี้เท่านั้น

เวลาที่สร้างทาสก์ เป็นหน่วยมิลลิวินาทีแบบ Unix

เวลาที่ทาสก์เริ่มทำงาน เป็นหน่วยมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่าทาสก์จะเริ่มทำงาน

เวลาที่ทาสก์เสร็จสิ้น เป็นหน่วยมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่าทาสก์จะเสร็จสิ้น

เวลาที่ผลลัพธ์ของทาสก์จะหมดอายุ เป็นหน่วยมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่าทาสก์จะเสร็จสิ้น

รายละเอียดข้อผิดพลาดเมื่อทาสก์ล้มเหลว ดู ข้อผิดพลาด

จำนวนเครดิตที่ทาสก์ใช้ไป: 20 หรือ 0 สำหรับทาสก์ที่ FAILED ซึ่ง Meshy จะคืนเครดิตให้