วิธีใช้ Image to 3D Model API: คู่มือฉบับสมบูรณ์ 2026

Image to 3D Model API เปลี่ยนภาพถ่ายเดี่ยวให้เป็น โมเดล 3D ที่พร้อมใช้งานในไม่กี่วินาที—โดยไม่ต้องสร้างโมเดลด้วยมือ การสร้างโมเดลแอสเซทด้วยมือนั้นช้าและมีค่าใช้จ่ายสูง และสำหรับสตูดิโอเกม, แอป AR และทีมอีคอมเมิร์ซ มันกลายเป็น คอขวดที่ทำให้การเปิดตัวล่าช้า API Image to 3D ของ Meshy ขจัดอุปสรรคนั้น: ส่งภาพ, แปลงเป็นโมเดล 3D ในไม่กี่วินาที และดาวน์โหลดเมชที่มีพื้นผิวสมบูรณ์ในรูปแบบต่างๆ เช่น GLB, FBX และ OBJ คู่มือนี้จะแนะนำคุณตลอดขั้นตอนการทำงานทั้งหมด—ตั้งแต่การสร้างคีย์ API ไปจนถึงการดาวน์โหลดโมเดลแรกของคุณ—พร้อมโค้ดที่สามารถคัดลอกและวางเพื่อรันได้ภายในไม่กี่นาที

Image to 3D Model API คืออะไร?

โดยแก่นแท้แล้ว Image to 3D Model API คือ REST endpoint ที่ขับเคลื่อนโดย AI Image to 3D ของ Meshy คุณส่งภาพเดียว (JPG, JPEG หรือ PNG) เป็น URL สาธารณะหรือสตริง base64 และ API จะส่งคืน โมเดล 3D ที่มีพื้นผิว—รวมถึงเรขาคณิตและพื้นผิวสีพื้นฐาน—ในรูปแบบมาตรฐาน เช่น GLB, FBX, OBJ, USDZ, STL และ 3MF ตัวเลือกเสริมประกอบด้วยแผนที่ PBR, พื้นผิวสูงถึง 4K และภาพขนาดย่อตัวอย่างหลายมุม

ขับเคลื่อนโดยโมเดล Meshy 6 ล่าสุดของเรา API ช่วยให้คุณกำหนดค่าโทโพโลยีและจำนวนรูปหลายเหลี่ยม, ตั้งค่าโหมดท่าทาง และแนะนำการสร้างพื้นผิวด้วยข้อความแจ้งหรือภาพอ้างอิง—เหมาะสำหรับการสร้างแอสเซทสำหรับเกม, AR/VR, การพิมพ์ 3D และการแสดงภาพผลิตภัณฑ์

คุณต้องใช้อะไรบ้างในการใช้ Image to 3D API?

คุณไม่จำเป็นต้องมีอะไรมากมายเพื่อทำตามคู่มือนี้ ตรวจสอบให้แน่ใจว่าคุณมี:

• บัญชี Meshy — ลงทะเบียนฟรี หากคุณยังไม่มี คุณจะสร้างคีย์ API จากแดชบอร์ดในขั้นตอนที่ 1

• คีย์ API — ใช้สำหรับตรวจสอบสิทธิ์ทุกคำขอ เราจะแนะนำขั้นตอนการสร้าง และคุณสามารถใช้ คีย์โหมดทดสอบ ฟรีเพื่อทำตามโดยไม่ต้องใช้เครดิต

• ภาพอินพุต — ไฟล์ .jpg, .jpeg หรือ .png ที่ชัดเจนซึ่งโฮสต์ที่ URL ที่เข้าถึงได้แบบสาธารณะ (หรือเข้ารหัสเป็น base64) พื้นหลังที่สะอาดและวัตถุที่มองเห็นได้ชัดเจนจะให้ผลลัพธ์ที่ดีที่สุด

• วิธีการส่งคำขอ HTTP — curl (ใช้ในตัวอย่างด้านล่าง), Postman หรือไลบรารี HTTP ใดๆ ในภาษาที่คุณเลือก ความคุ้นเคยพื้นฐานกับ REST API และ JSON จะเป็นประโยชน์แต่ไม่จำเป็น

เท่านี้ก็เรียบร้อย—ไม่จำเป็นต้องมีประสบการณ์ด้านการสร้างโมเดล 3D มาเริ่มกันเลย

วิธีแปลงภาพเป็นโมเดล 3D ด้วย API (คำแนะนำทีละขั้นตอน)

ขั้นตอนที่ 1: ตั้งค่าการตั้งค่า API ของคุณ

ทุกสิ่งที่คุณต้องการเพื่อเริ่มต้นสร้างอยู่ที่ หน้าการตั้งค่า API นี่คือศูนย์ควบคุมสำหรับ Meshy API และมีสามส่วนหลัก:

• คีย์ API — สร้างและจัดการคีย์ที่ตรวจสอบสิทธิ์คำขอของคุณ

• Webhooks — รับการแจ้งเตือนโดยอัตโนมัติเมื่องานของคุณเสร็จสิ้น

• การใช้งาน — ติดตามยอดเครดิตคงเหลือและการบริโภค API แบบเรียลไทม์

มาดูแต่ละส่วนกัน

รับคีย์ API ของคุณ

ก่อนที่จะส่งคำขอใดๆ คุณต้องมีคีย์ API เพื่อตรวจสอบสิทธิ์อย่างปลอดภัย บน หน้าการตั้งค่า API คลิก สร้างคีย์ API ทุกคีย์จะมีรูปแบบ msy-<สตริงสุ่ม>

เคล็ดลับ: เมื่อสร้างแล้ว ให้เก็บคีย์ API ของคุณไว้ในที่ปลอดภัย (เช่น ตัวจัดการรหัสผ่านหรือตัวแปรสภาพแวดล้อม) ปฏิบัติต่อมันเหมือนรหัสผ่าน—อย่า commit ลงในระบบควบคุมเวอร์ชันหรือเปิดเผยในโค้ดฝั่งไคลเอ็นต์

คีย์ API โหมดทดสอบ

ระหว่างการพัฒนาและทดสอบ คุณสามารถใช้ คีย์ API โหมดทดสอบ เพื่อสำรวจ API โดยไม่ใช้เครดิตของคุณ:

msy_dummy_api_key_for_test_mode_12345678

คีย์พิเศษนี้มีลักษณะดังต่อไปนี้:

• สามารถใช้เพื่อส่งคำขอไปยัง ทุก endpoint ของ Meshy API

• ไม่มีการใช้เครดิต เมื่อใช้คีย์นี้

• คำขอที่ถูกต้องทั้งหมดจะส่งคืน ผลลัพธ์งานตัวอย่างเดียวกัน โดยไม่คำนึงถึงพารามิเตอร์อินพุต

• โครงสร้างข้อมูลการตอบสนอง ตรงกับ API จริงทุกประการ

这使得它非常适合在切换到真实 API 密钥之前测试您的集成。

ตั้งค่า Webhooks (ไม่บังคับ)

การสร้างโมเดล 3D ต้องใช้เวลา ดังนั้นแทนที่จะสอบถาม API ซ้ำๆ เพื่อตรวจสอบว่างานเสร็จหรือไม่ คุณสามารถให้ Meshy แจ้งเตือนคุณทันทีที่งานเสร็จ นั่นคือสิ่งที่ webhooks มีไว้

ในส่วน Webhooks ของหน้าการตั้งค่า ให้เพิ่ม URL endpoint ที่ Meshy ควรส่งการแจ้งเตือนเหตุการณ์ไป เมื่อสถานะของงานเปลี่ยนแปลง (เช่น ���มื่อเสร็จสมบูรณ์หรือล้มเหลว) Meshy จะส่งคำขอ HTTP POST ไปยัง URL ของคุณพร้อมรายละเอียดงานใน payload

เคล็ดลับ: Webhooks เป็นแนวทางที่แนะนำสำหรับการใช้งานจริง ซึ่งช่วยลดการเรียก API ที่ไม่จำเป็นและช่วยให้แอปพลิเคชันของคุณตอบสนองต่อผลลัพธ์แบบเรียลไทม์ สำหรับการทดสอบอย่างรวดเร็ว การสอบถามก็ยังใช้ได้ดี หากต้องการทดสอบโค้ด webhook ในเครื่อง ให้ชี้ไปที่ URL พร็อกซีจากบริการเช่น smee.io

ลองใช้โดยไม่ต้องเขียนโค้ด — API Playground (ไม่บังคับ)

มีคีย์ API แล้วหรือยัง? ก่อนที่จะเขียนโค้ดใดๆ คุณสามารถรันงาน Image to 3D จริงได้โดยตรงในเบราว์เซอร์ของคุณ

เปิด meshy.ai/api-playground เลือก Image to 3D จากแผงด้านซ้าย และกรอกสามสิ่ง:

1. Authorization — วางคีย์ API ของคุณ (msy-xxxxxxxxxx)

2. Image — อัปโหลดไฟล์ .jpg, .jpeg หรือ .png จากคอมพิวเตอร์ของคุณ

3. กด Send

Playground จะส่งงานและสอบถามผลลัพธ์โดยอัตโนมัติ เมื่อเสร็จแล้ว คุณจะเห็นตัวอย่างโมเดล 3D และลิงก์ดาวน์โหลดในเบราว์เซอร์ทันที — ไม่ต้องใช้โค้ด

เคล็ดลับมือโปร: แผงคำขอ/การตอบสนองดิบทางด้านขวาจะแสดงสิ่งที่ API ส่งและส่งคืนอย่างแน่นอน คุณสามารถคัดลอกเนื้อหาได้โดยตรง — ดึง task_id จากการตอบสนอง และ model_urls เมื่องานเสร็จสิ้น คุณจะใช้ทั้งสองอย่างในขั้นตอนถัดไป

ขั้นตอนที่ 2: ส่งงาน Image to 3D

เมื่อคีย์ API พร้อมแล้ว ให้เริ่มงานด้วยคำขอ POST เดียว:

curl -X POST https://api.meshy.ai/openapi/v1/image-to-3d \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/your-image.png"
  }'

คุณจะได้รับการตอบสนองดังนี้:

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

ค่า result นั้นคือ task_id ของคุณ — บันทึกไว้ คุณจะต้องใช้ในขั้นตอนถัดไปเพื่อตรวจสอบความคืบหน้าและรับโมเดลของคุณ

ไม่บังคับ: เพื่อรับการแจ้งเตือนโดยอัตโนมัติเมื่องานเสร็จสิ้น ให้เพิ่มฟิลด์ webhook_url ในเนื้อหา JSON — ตัวอย่างเช่น "webhook_url": "https://yourapp.com/webhooks/meshy" ดูขั้นตอนที่ 3, ตัวเลือก B สำหรับวิธีการทำงาน

ขั้นตอนที่ 3: รับผลลัพธ์ของคุณ

งานของคุณไม่ได้เสร็จทันที — Meshy ประมวลผลในเบื้องหลัง คุณมี สองวิธีในการรับผลลัพธ์:

ตัวเลือก A: สอบถามสถานะ (ง่ายที่สุด)

ส่งคำขอ GET ทุก 5 วินาทีจนกว่า status จะเปลี่ยนเป็น SUCCEEDED:

curl https://api.meshy.ai/openapi/v1/image-to-3d/{task_id} \
  -H "Authorization: Bearer $MESHY_API_KEY"

การตอบสนองจะมีลักษณะดังนี้:

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "SUCCEEDED",
  "progress": 100,
  "model_url": "https://assets.meshy.ai/.../model.glb",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb",
    "fbx": "https://assets.meshy.ai/.../model.fbx",
    "obj": "https://assets.meshy.ai/.../model.obj",
    "usdz": "https://assets.meshy.ai/.../model.usdz",
    "stl": "https://assets.meshy.ai/.../model.stl",
    "mtl": "https://assets.meshy.ai/.../model.mtl"
  },
  "thumbnail_url": "https://assets.meshy.ai/.../thumbnail.png",
  "consumed_credits": 30
}

ฟิลด์บางส่วนที่ควรทราบ:

• model_urls เก็บลิงก์ดาวน์โหลดสำหรับทุกรูปแบบที่สร้างขึ้น โดยค่าเริ่มต้นจะรวม glb, fbx, obj, usdz, stl และ mtl (ไฟล์วัสดุที่จับคู่กับ obj)

• model_url เป็นทางลัดไปยังลิงก์ GLB — สะดวกเมื่อคุณต้องการแค่ GLB

• consumed_credits แสดงจำนวนเครดิตที่งานใช้ไป (เป็น 0 สำหรับงานที่ล้มเหลว เนื่องจากเครดิตจะถูกคืน)

• thumbnail_url จะปรากฏเสมอและชี้ไปที่ภาพขนาดย่อมุมมองด้านหน้า

• thumbnail_urls จะปรากฏเฉพาะเมื่อ multi_view_thumbnails: true และมีมุมมองด้านหน้า, ด้านขวา, ด้านหลัง และด้านซ้าย

• alpha_thumbnail_url จะปรากฏเฉพาะเมื่อ alpha_thumbnail: true และเก็บภาพขนาดย่อพื้นหลังโปร่งใส

ค่า status ที่เป็นไปได้: PENDING → IN_PROGRESS → SUCCEEDED / FAILED / CANCELED

ตัวเลือก B: Webhook (แนะนำสำหรับการใช้งานจริง)

หากคุณตั้งค่า webhook_url ในขั้นตอนที่ 2 Meshy จะ POST ออบเจกต์งานที่เสร็จสมบูรณ์ไปยัง URL ของคุณโดยอัตโนมัติ — ไม่ต้องสอบถาม

{
  "image_url": "https://example.com/your-image.png",
  "webhook_url": "https://yourapp.com/webhooks/meshy"
}

💡 我应该使用哪一个？ การสอบถามนั้นใช้ได้ดีสำหรับการสร้างต้นแบบและงานครั้งเดียว ใช้ webhooks ในการใช้งานจริง — เชื่อถือได้มากกว่าและประหยัดการเรียก API

ขั้นตอนที่ 4: ดาวน์โหลดโมเดล 3D ของคุณ

เมื่อ status เป็น SUCCEEDED แล้ว ให้ดึง URL ดาวน์โหลดจาก model_urls และดาวน์โหลดรูปแบบที่คุณต้องการ:

curl -o model.glb "https://assets.meshy.ai/.../model.glb"

แฟล็ก -o model.glb จะบันทึกไฟล์ไปยังไดเรกทอรีทำงานปัจจุบันของคุณภายใต้ชื่อนั้น — ใช้พาธแบบเต็ม (เช่น -o /path/to/model.glb) เพื่อบันทึกไว้ที่อื่น

โดยค่าเริ่มต้น ทุกงานจะส่งคืน GLB, FBX, OBJ, USDZ, STL และ MTL (ไฟล์วัสดุสำหรับ OBJ) 3MF เป็นแบบเลือกเข้าร่วม — คุณจะได้รับก็ต่อเมื่อคุณร้องขออย่างชัดเจนผ่าน target_formats (ดูตารางพารามิเตอร์ด้านล่าง)

⚠️ ลิงก์หมดอายุใน 3 วัน (แผน Enterprise จะได้รับลิงก์ถาวร) ดาวน์โหลดและจัดเก็บโมเดลของคุณทันที — ลิงก์จะใช้ไม่ได้หลังจากหมดอายุ และคุณจะต้องรันงานอีกครั้ง

พร้อมที่จะใช้โมเดลนี้ในเครื่องมือ DCC ของคุณหรือยัง? ดูคู่มือ Bridge to Blender — Meshy ยังมี bridges สำหรับ Unity, Unreal, Maya และ อื่นๆ อีกมากมาย

จะได้ผลลัพธ์ Image-to-3D ที่ดีที่สุดได้อย่างไร?

• ใช้วัตถุเดียวที่มองเห็นได้ชัดเจน วัตถุหลักหนึ่งชิ้น อยู่ตรงกลางและอยู่ในเฟรมอย่างเต็มที่ จะทำให้ AI มีข้อมูลอ้างอิงที่ชัดเจนที่สุด — หลีกเลี่ยงฉากที่รก, การครอบตัดมากเกินไป และมุมที่รุนแรง

• เลือกพื้นหลังที่สะอาดและไม่รก พื้นหลังทึบหรือเรียบง่ายช่วยให้โมเดลแยกวัตถุออกจากสภาพแวดล้อมได้

• ใช้แสงแบบกระจายที่สม่ำเสมอ เงาที่รุนแรงและไฮไลท์ที่แรงสามารถสร้างรายละเอียดที่ทำให้เข้าใจผิดในพื้นผิวที่สร้างขึ้นได้

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

ฉันสามารถใช้ภาษาโปรแกรมใดกับ Image to 3D API ได้บ้าง?

ภาษาใดก็ได้ที่สามารถส่งคำขอ HTTP ได้ — คุณส่ง POST พร้อม JSON และสอบถามด้วย GET ตัวเลือกทั่วไป:

• Python — ใช้ไลบรารี requests หรือ httpx

• JavaScript / TypeScript — ใช้ fetch (ในตัว) หรือ axios

• Go — ใช้ net/http จากไลบรารีมาตรฐาน

• cURL — เหมาะสำหรับการทดสอบอย่างรวดเร็วจากเทอร์มินัล

คุณยังสามารถค้นหาตัวอย่างโค้ดที่พร้อมคัดลอกสำหรับทั้งสี่ภาษาได้ใน API Playground

งาน Image to 3D หนึ่งงานใช้เครดิตเท่าไหร่?

ค่าใช้จ่ายขึ้นอยู่กับเวอร์ชันของโมเดลและว่าคุณสร้างพื้นผิวหรือไม่ การตั้งค่าเริ่มต้น (meshy-6 พร้อมการสร้างพื้นผิว) มีค่าใช้จ่าย 30 เครดิต ต่องาน:

งานที่ล้มเหลวจะได้รับเครดิตคืนโดยอัตโนมัติ — consumed_credits จะส่งคืน 0 ตรวจสอบ ราคา สำหรับอัตราล่าสุดเสมอ

Image to 3D API ยอมรับพารามิเตอร์ใดบ้าง?

ส่ง POST ไปที่ /openapi/v1/image-to-3d ด้วยพารามิเตอร์เหล่านี้: จำเป็น (หนึ่งในนั้น):

ไม่บังคับ:

ขั้นตอนถัดไปกับ Image to 3D API

ตอนนี้คุณมี ขั้นตอนการทำงานที่สมบูรณ์ แล้ว: สร้างคีย์ API, ส่งภาพ, สอบถามหรือใช้ webhook เพื่อรับผลลัพธ์ จากนั้นดา���น์โหลดโมเดลของคุณ สี่ขั้นตอนเดียวกันนี้สามารถปรับขนาด จากต้นแบบอย่างรวดเร็วไปจนถึงไปป์ไลน์การผลิต ที่เปลี่ยนภาพนับพันเป็นแอสเซท 3D โดยอัตโนมัติ รับคีย์ของคุณจาก หน้าการตั้งค่า API และส่งโมเดลแรกของคุณวันนี้ ชอบเริ่มต้นจากข้อความแจ้งมากกว่าภาพถ่าย? ใช้ Text to 3D Model API

คำถามที่พบบ่อย

ฉันจะแปลงภาพเป็นโมเดล 3D ผ่าน API ได้อย่างไร?

ส่งคำขอ POST ไปที่ /openapi/v1/image-to-3d พร้อม image_url และคีย์ API ของคุณ จากนั้นสอบถามงาน (หรือใช้ webhook) จนกว่า status จะเป็น SUCCEEDED การตอบสนองจะส่งคืนลิงก์ดาวน์โหลดสำหรับโมเดลที่สร้างขึ้น ขั้นตอนการทำงานสี่ขั้นตอนเต็ม — คีย์, ส่ง, ดึงข้อมูล, ดาวน์โหลด — มีอยู่ในคำแนะนำทีละขั้นตอนด้านบน

API รองรับรูปแบบผลลัพธ์ใดบ้าง (STL, GLB, OBJ)?

ทุกงานจะส่งคืน GLB, FBX, OBJ, USDZ, STL และ MTL โดยค่าเริ่มต้น โดยมี 3MF ให้บริการเมื่อร้องขอผ่าน target_formats GLB เหมาะที่สุดสำหรับเว็บและ AR, FBX และ OBJ สำหรับเครื่องมือ DCC และเอนจินเกม, USDZ สำหรับ iOS AR และ STL สำหรับการพิมพ์ 3D

ฉันสามารถอัปโหลดรูปแบบภาพใดได้บ้าง?

Image to 3D API รองรับภาพ JPG, JPEG และ PNG สูงสุด 100 MB — ใหญ่กว่าขีดจำกัด 20 MB ใน UI ของ Meshy Workspace เพื่อผลลัพธ์ที่แม่นยำที่สุด ให้ใช้ PNG ที่มีพื้นหลังโปร่งใสหรือสีขาวสะอาด ซึ่งช่วยให้ API แยกวัตถุและสร้างโมเดล 3D ที่มีคุณภาพสูงขึ้น

ฉันสามารถรับโมเดล 3D ที่มีพื้นผิวจาก API ได้หรือไม่?

ได้ การสร้างพื้นผิวเปิดใช้งานโดยค่าเริ่มต้น ("should_texture": true) หากต้องการเพิ่มแผนที่ PBR (metallic, roughness, normal) ให้ตั้งค่า "enable_pbr": true — บน meshy-6/latest จะรวมแผนที่ emission ด้วย สำหรับพื้นผิวสีพื้นฐาน 4K ให้ตั้งค่า "hd_texture": true (รองรับเฉพาะ meshy-6/latest เท่านั้น; แผนที่ PBR จะอยู่ที่ 2K เสมอ) คุณยังสามารถกำหนดสไตล์พื้นผิวด้วย texture_prompt หรือ texture_image_url

ฉันสามารถสร้างโมเดล 3D ที่พร้อมสำหรับการพิมพ์ 3D (STL) ได้หรือไม่?

ได้ — STL ถูกสร้างขึ้นโดยค่าเริ่มต้น ดังนั้นการแปลงภาพเป็น 3D STL จึงไม่จำเป็นต้องมีพารามิเตอร์เพิ่มเติม: เพียงแค่ดึง model_urls.stl เมื่องานเสร็จสมบูรณ์ ซึ่งทำให้ขั้นตอนการทำงานภาพไปยังการพิมพ์ 3D ง่าย เนื่องจาก STL เป็นรูปแบบมาตรฐานที่ซอฟต์แวร์สไลเซอร์คาดหวัง หากคุณ ต้องการ แค่ STL ให้ตั้งค่า "target_formats": ["stl"] เพื่อข้ามรูปแบบอื่นและลดเวลาในการสร้าง

แผนใดบ้างที่รวมการเข้าถึง API?

การเข้าถึง API มีให้ในแผน Pro, Studio และ Enterprise — เป็นฟีเจอร์สำหรับ Pro ขึ้นไป แผน Starter ฟรีไม่รวมการเข้าถึง API ดู ราคา สำหรับรายละเอียด

ลิงก์ดาวน์โหลดใช้ได้นานเท่าไหร่?

ลิงก์ดาวน์โหลดใช้ได้ 3 วัน สำหรับแผน Pro และ Studio ลูกค้า Enterprise จะได้รับลิงก์ถาวร บันทึกไฟล์ของคุณทันที — ลิงก์ที่หมดอายุไม่สามารถกู้คืนได้ และคุณจะต้องรันงานอีกครั้ง

ฉันสามารถรันหลายงานพร้อมกันได้หรือไม่?

ได้ รองรับคำขอพร้อมกัน หากคุณพบข้อผิดพลาด 429 Too Many Requests บัญชีของคุณถึงขีดจำกัดอัตราแล้ว — ให้ใช้ exponential backoff และลองใหม่ ดูหน้า ขีดจำกัดอัตรา สำหรับขีดจำกัดของแผนของคุณ

งานแสดง FAILED — ฉันควรทำอย่างไร?

ตรวจสอบ task_error.message เพื่อหาสาเหตุ สาเหตุทั่วไป:

หากปัญหายังคงอยู่ โปรดติดต่อ ฝ่ายสนับสนุน Meshy