Multi-Image to 3D API

สร้างโมเดล 3D จากภาพหนึ่งถึงสี่ภาพของวัตถุเดียวกัน ที่ถ่ายจากมุมที่แตกต่างกัน

POST/openapi/v1/multi-image-to-3d

สร้างงาน หลายรูปเป็น 3D

สร้างงาน หลายรูปเป็น 3D งานนี้ทำงานอยู่เบื้องหลัง สำหรับระยะเวลาที่งานมักใช้ ดูที่ ระยะเวลาในการประมวลผล สำหรับฟิลด์ต่าง ๆ ที่งานนี้มี ดูที่ อ็อบเจกต์งาน หลายรูปเป็น 3D

Request

POST

/openapi/v1/multi-image-to-3d

# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# With Ultra 2K geometry, PBR texturing, and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "geometry_resolution": "2k",
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

# Textured with Meshy N1 from the input images, the first as the front view
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your front view image url or base64-encoded data URI>",
      "<your back view image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "texture_model": "meshy-n1"
  }'

Response

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

พารามิเตอร์

Name
input_task_id
Type
string
จำเป็น
Description
จำเป็นต้องส่ง เว้นแต่คุณจะส่ง image_urls คือ ID ของงาน ข้อความเป็นรูปภาพ หรือ รูปภาพเป็นรูปภาพ รวมถึงงานแบบ มุมมองหลายด้าน ด้วย Meshy จะใช้รูปภาพหนึ่งถึงสี่รูปของงานนั้นเป็นอินพุต งานนี้ต้องเป็นงานที่คุณสร้างด้วย API และมีสถานะเป็น SUCCEEDED

Name
image_urls
Type
array
จำเป็น
Description
จำเป็นต้องส่ง เว้นแต่คุณจะส่ง input_task_id รูปภาพหนึ่งถึงสี่รูป แต่ละรูปเป็น URL สาธารณะหรือ Data URI เช่น data:image/jpeg;base64,<your base64-encoded image data> หากคุณส่งทั้งสองอย่าง Meshy จะใช้ input_task_id
แต่ละรูปต้องเป็นไฟล์ .jpg, .jpeg, .png, หรือ .webp ขนาดไม่เกิน 20 MB มีด้านละอย่างน้อย 32 พิกเซล และไม่เกิน 178,956,970 พิกเซล (กว้าง × สูง) หากส่งมากกว่าสี่รูปจะได้รับ 400
เพื่อผลลัพธ์ที่ดีที่สุด รูปภาพควรแสดงวัตถุเดียวกันจากมุมที่ต่างกัน เมื่อใช้ meshy-7.1 หรือ latest Meshy จะใช้รูปแรกเป็นมุมมองด้านหน้า และลำดับของรูปอื่น ๆ ไม่มีผล

Name
ai_model
Type
string
ค่าเริ่มต้น latest
Description
โมเดล AI ที่สร้างโมเดล 3D
ค่าที่ใช้ได้:
- latest: Meshy 7.1
- meshy-7.1
- meshy-6
- meshy-6-lite
- meshy-7: เลิกใช้ ให้ส่ง meshy-7.1 แทน
ดู โมเดล เพื่อดูว่าโมเดลใดเหมาะกับโปรเจกต์ของคุณ เช่น วัตถุจริงหรือสิ่งพิมพ์ 3 มิติ
Name
geometry_resolution
Type
string
ค่าเริ่มต้น standard
Description
ระดับรายละเอียดของจีออเมทรีที่จะสร้าง
ค่าที่ใช้ได้:
- standard
- 2k: รันขั้นตอน Ultra ที่ 2048³ ต้องใช้ meshy-7.1, latest, หรือ meshy-7 ที่เลิกใช้แล้ว
Name
ultra_mode
Type
boolean
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น false
Description
ให้ส่ง geometry_resolution แทน ultra_mode: true มีผลเหมือนกับ geometry_resolution: "2k"
Name
should_texture
Type
boolean
ค่าเริ่มต้น true
Description
ว่าจะสร้างเท็กซ์เจอร์หรือไม่ true จะส่งคืนโมเดลที่มีเท็กซ์เจอร์ และ false จะข้ามขั้นตอนการทำเท็กซ์เจอร์และส่งคืนเมชที่ไม่มีเท็กซ์เจอร์

ใช้เฉพาะเมื่อ should_texture = true

Name
texture_model
Type
string
ค่าเริ่มต้น depends on ai_model
Description
โมเดล AI ที่ทำเท็กซ์เจอร์ให้โมเดล 3D จากหลายมุมมองในงานเดียวกัน ปล่อยว่างไว้เพื่อใช้โมเดลเท็กซ์เจอร์เริ่มต้นสำหรับ ai_model ของคุณ ไม่มีผลต่อค่าใช้จ่ายด้านเครดิต
ค่าที่ใช้ได้:
- meshy-7: Meshy 7 พร้อม PBR แมปและเท็กซ์เจอร์สูงสุด 8K
- meshy-n1: Meshy N1 เท็กซ์เจอร์สีพื้นฐาน 2K จากรูปภาพอ้างอิงเท่านั้น
ai_model ทุกตัวรองรับทั้งสองค่านี้ คำขอที่มีเท็กซ์เจอร์กับ meshy-6 หรือ meshy-6-lite จะได้รับ 400 เช่นเดียวกับตัวเลือกที่โมเดลเท็กซ์เจอร์ที่เลือกไม่รองรับ เมื่อใช้ should_texture: false Meshy จะไม่สนใจ texture_model แต่หากเป็นค่าที่ไม่รู้จักก็ยังคงส่งคืน 400
เมื่อใช้ meshy-n1 Meshy จะทำเท็กซ์เจอร์จาก texture_image_urls หรือ texture_image_url หรือจากรูปภาพอินพุตเมื่อคุณไม่ได้ส่งทั้งสองอย่าง รูปแรกคือมุมมองด้านหน้า หากโมเดลที่สร้างขึ้นมีมากกว่า 7,999,999 สามเหลี่ยม งานจะล้มเหลว และ Meshy จะคืนเครดิตให้
ดู โมเดล เพื่อดูว่าโมเดลเท็กซ์เจอร์แต่ละตัวทำอะไรและควรเลือกตัวใด
Name
enable_pbr
Type
boolean
ค่าเริ่มต้น false
Description
ว่าจะสร้างแมปความเป็นโลหะ ความหยาบ และแมปปกติ นอกเหนือจากสีพื้นฐานหรือไม่ โมเดลเท็กซ์เจอร์ Meshy 6 ยังสร้างแมปการแผ่รังสี (emission map) ด้วย ยกเว้นที่ texture_resolution: 8k เมื่อใช้ texture_model: meshy-n1 การส่ง true จะได้รับ 400
Name
texture_resolution
Type
string
ค่าเริ่มต้น 2k
Description
ขนาดของเท็กซ์เจอร์สีพื้นฐาน ขนาดที่ใหญ่ขึ้นจะเก็บรายละเอียดพื้นผิวได้มากขึ้น
ค่าที่ใช้ได้:
- 2k: 2048×2048
- 4k: 4096×4096
- 8k: 8192×8192
4k และ 8k ต้องใช้โมเดลเท็กซ์เจอร์ Meshy 7 หรือ Meshy 6 และจะได้รับ 400 กับตัวอื่น ๆ ที่ 8k Meshy จะไม่สร้างแมปการแผ่รังสี
Name
hd_texture
Type
boolean
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น false
Description
ให้ส่ง texture_resolution แทน hd_texture: true มีผลเหมือนกับ texture_resolution: "4k" หากคุณส่งทั้งสองอย่าง Meshy จะใช้ texture_resolution
Name
texture_prompt
Type
string
Description
ข้อความที่ใช้นำทางเท็กซ์เจอร์ ยาวได้สูงสุด 800 ตัวอักษร ข้อความที่ยาวกว่านี้จะได้รับ 400 เมื่อใช้ texture_model: meshy-n1 การส่งค่านี้จะได้รับ 400
Name
texture_image_url
Type
string
Description
รูปภาพ 2 มิติหนึ่งรูปที่ใช้นำทางเท็กซ์เจอร์ เป็น URL สาธารณะหรือ Data URI เช่น data:image/jpeg;base64,<your base64-encoded image data> รูปภาพต้องเป็นไฟล์ .jpg, .jpeg, .png, หรือ .webp ขนาดไม่เกิน 20 MB มีด้านละอย่างน้อย 32 พิกเซล และไม่เกิน 178,956,970 พิกเซล (กว้าง × สูง)
หากคุณส่งทั้ง texture_image_url และ texture_prompt Meshy จะใช้ texture_prompt เมื่อใช้ texture_model: meshy-n1 Meshy จะทำเท็กซ์เจอร์จากรูปนี้เป็นมุมมองด้านหน้า
เท็กซ์เจอร์อาจออกมาไม่ดีนักเมื่อรูปทรงในรูปภาพแตกต่างจากโมเดล 3D มาก
Name
texture_image_urls
Type
string[]
Description
รูปภาพหนึ่งถึงสี่รูปของวัตถุจากมุมมองต่าง ๆ ที่ใช้นำทางเท็กซ์เจอร์ Meshy จะใช้รูปแรกเป็นมุมมองด้านหน้า ลำดับของมุมมองอื่น ๆ (ซ้าย หลัง ขวา) ไม่มีผล
แต่ละรูปเป็นไปตามกฎเดียวกับ texture_image_url คือเป็น URL สาธารณะหรือ Data URI ในรูปแบบ .jpg, .jpeg, .png, หรือ .webp ขนาดไม่เกิน 20 MB มีด้านละอย่างน้อย 32 พิกเซล และไม่เกิน 178,956,970 พิกเซล (กว้าง × สูง)
รูปภาพเหล่านี้ใช้นำทางเฉพาะเท็กซ์เจอร์เท่านั้น และไม่ขึ้นกับ image_urls ทั้งสองรายการสามารถมีรูปภาพที่ต่างกันและจำนวนรูปที่ต่างกันได้
texture_image_urls ต้องใช้โมเดลเท็กซ์เจอร์ Meshy 7 หรือ Meshy N1 ให้ส่งค่านี้พร้อมกับหนึ่งในตัวเลือกต่อไปนี้:
- ai_model เป็น meshy-7.1, latest, หรือ meshy-7 ที่เลิกใช้แล้ว
- texture_model เป็น meshy-7 หรือ meshy-n1
คุณไม่สามารถส่งค่านี้พร้อมกับ texture_image_url หรือ texture_prompt ได้

Name
should_remesh
Type
boolean
ค่าเริ่มต้น true (meshy-6-lite), false (other models)
Description
ว่าจะรีเมชโมเดลหลังจากสร้างเสร็จหรือไม่ สำหรับโมเดล 3D ที่มีคุณภาพสูงสุด ให้ตั้งค่าเป็น false

ใช้เฉพาะเมื่อ should_remesh = true

Name
topology
Type
string
ค่าเริ่มต้น triangle
Description
ประเภทหน้าของโมเดลที่ผ่านการรีเมช
ค่าที่ใช้ได้:
- quad: เมชที่ใช้รูปสี่เหลี่ยมเป็นหลัก
- triangle: เมชสามเหลี่ยมแบบลดจำนวนหน้า
เมื่อใช้ texture_model: meshy-n1 ค่า quad จะได้รับ 400 เมื่อโมเดลถูกรีเมช ซึ่ง meshy-6-lite ทำเช่นนั้นโดยค่าเริ่มต้น
Name
target_polycount
Type
integer
ค่าเริ่มต้น 30000
Description
จำนวนหน้าที่ต้องการ ตั้งแต่ 100 ถึง 300000 ผลลัพธ์อาจแตกต่างจากเป้าหมาย ขึ้นอยู่กับจีออเมทรีของโมเดล ค่าที่อยู่นอกช่วงนี้จะได้รับ 400
Name
decimation_mode
Type
integer
Description
จำนวนหน้าแบบปรับได้ ตามระดับ เมื่อคุณตั้งค่านี้ Meshy จะไม่สนใจ target_polycount
ค่าที่ใช้ได้:
- 1: สูงสุด (ultra)
- 2: สูง (high)
- 3: ปานกลาง (medium)
- 4: ต่ำ (low)
Name
save_pre_remeshed_model
Type
boolean
ค่าเริ่มต้น false
Description
ว่าจะบันทึกไฟล์ GLB ก่อนรีเมชด้วยหรือไม่ ซึ่งจะถูกส่งคืนใน model_urls.pre_remeshed_glb

Name
symmetry_mode
Type
string
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น auto
Description
ปล่อยว่างไว้ ไม่มีผลต่อเอาต์พุต
ค่าที่ใช้ได้:
- off: ไม่มีสมมาตร
- auto: สมมาตรตามจีออเมทรีของอินพุต
- on: บังคับให้มีสมมาตร
Name
pose_mode
Type
string
ค่าเริ่มต้น ""
Description
ท่าทางของโมเดลที่สร้างขึ้น
ค่าที่ใช้ได้:
- a-pose: ท่า A
- t-pose: ท่า T
- "" (สตริงว่าง): ไม่มีท่าทางเฉพาะ
Name
is_a_t_pose
Type
boolean
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น false
Description
ให้ส่ง pose_mode แทน ใช้กำหนดว่าจะสร้างโมเดลในท่า A หรือ T หรือไม่
Name
image_enhancement
Type
boolean
ค่าเริ่มต้น true
Description
ว่าจะปรับปรุงรูปภาพอินพุตก่อนสร้างหรือไม่ false จะคงลักษณะที่แน่นอนของรูปภาพอินพุตไว้ โดยไม่มีการประมวลผลสไตล์ รองรับเฉพาะ meshy-6, meshy-7.1, หรือ latest หากส่งพร้อมกับ meshy-6-lite จะได้รับ 400
Name
remove_lighting
Type
boolean
ค่าเริ่มต้น true
Description
ว่าจะลบจุดไฮไลต์และเงาออกจากเท็กซ์เจอร์สีพื้นฐานหรือไม่ ผลลัพธ์ที่สะอาดขึ้นจะทำงานได้ดีกว่าภายใต้แสงของคุณเอง มีเพียงโมเดลเท็กซ์เจอร์ Meshy 6 เท่านั้นที่ใช้ค่านี้ และที่ texture_resolution: 8k จะลบแสงออกเสมอ เมื่อใช้ texture_model: meshy-n1 การส่ง true จะได้รับ 400 เมื่อใช้ ai_model: meshy-6-lite และโมเดลเท็กซ์เจอร์เริ่มต้นของมัน การส่งค่านี้จะได้รับ 400
Name
moderation
Type
boolean
ค่าเริ่มต้น false
Description
ว่าจะตรวจสอบอินพุตเพื่อหาเนื้อหาที่เป็นอันตรายหรือไม่ Meshy จะตรวจสอบรูปภาพอินพุตแต่ละรูป, texture_image_url หรือแต่ละรูปใน texture_image_urls และข้อความใน texture_prompt หาก Meshy พบเนื้อหาที่เป็นอันตราย คำขอจะส่งคืน 400 และ Meshy จะไม่สร้างงาน
Name
target_formats
Type
string[]
Description
รูปแบบไฟล์ 3D ที่จะสร้าง Meshy จะสร้างและส่งคืนเฉพาะรูปแบบที่คุณระบุไว้เท่านั้น ซึ่งอาจทำให้งานใช้เวลาสั้นลง
ค่าที่ใช้ได้:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
หากคุณไม่ระบุ Meshy จะสร้างทุกรูปแบบยกเว้น 3mf Meshy จะสร้าง 3mf ก็ต่อเมื่อคุณระบุไว้เท่านั้น
Name
auto_size
Type
boolean
ค่าเริ่มต้น false
Description
ว่าจะประมาณความสูงจริงของวัตถุด้วยการมองเห็นของ AI และปรับขนาดโมเดลให้ตรงกับความสูงนั้นหรือไม่ Meshy จะวางจุดกำเนิดไว้ที่ด้านล่าง เว้นแต่คุณจะตั้งค่า origin_at

ใช้เฉพาะเมื่อ auto_size = true

Name
origin_at
Type
string
ค่าเริ่มต้น bottom
Description
ตำแหน่งที่จะวางจุดกำเนิดของโมเดล bottom หรือ center

Name
alpha_thumbnail
Type
boolean
ค่าเริ่มต้น false
Description
ว่าจะเรนเดอร์ภาพตัวอย่างที่มีพื้นหลังโปร่งใส (RGBA) ด้วยหรือไม่ ซึ่งจะถูกส่งคืนใน alpha_thumbnail_url เมื่อคุณดึงข้อมูลงาน thumbnail_url จะไม่เปลี่ยนแปลง
Name
multi_view_thumbnails
Type
boolean
ค่าเริ่มต้น false
Description
ว่าจะเรนเดอร์ภาพตัวอย่างด้านหน้า ขวา หลัง และซ้ายด้วยหรือไม่ ซึ่งจะถูกส่งคืนใน thumbnail_urls เมื่อคุณดึงข้อมูลงาน thumbnail_url จะไม่เปลี่ยนแปลงและยังคงแสดงมุมมองด้านหน้า การทำเช่นนี้จะเพิ่มเวลาในงานประมาณ 5 วินาที

ผลลัพธ์ที่ส่งคืน

ฟิลด์ result ของการตอบกลับจะเก็บ ID ของงาน หลายรูปเป็น 3D ใหม่

รูปแบบความล้มเหลว

Name
400 - Bad Request
Description
คำขอนี้ไม่สามารถทำงานได้ ข้อความแสดงข้อผิดพลาดจะบอกว่าพบปัญหาใด ตัวอย่างเช่น:
- พารามิเตอร์ที่ขาดหายไป: ไม่มีการส่งทั้ง image_urls และ input_task_id
- งานอินพุตไม่ถูกต้อง: input_task_id ไม่ใช่งาน ข้อความเป็นรูปภาพ หรือ รูปภาพเป็นรูปภาพ ที่มีสถานะ SUCCEEDED หรือไม่ใช่งานแบบ มุมมองหลายด้าน
- จำนวนรูปภาพไม่ถูกต้อง: image_urls หรือ texture_image_urls ไม่มีรูปภาพ 1 ถึง 4 รูป
- รูปแบบรูปภาพไม่ถูกต้อง: รูปภาพใน image_urls ไม่ได้อยู่ในรูปแบบที่รองรับ
- อินพุตเท็กซ์เจอร์ขัดแย้งกัน: มีการส่ง texture_image_urls พร้อมกับ texture_image_url, texture_prompt, หรือ should_texture: false
- โมเดลไม่รองรับสำหรับเท็กซ์เจอร์หลายมุมมอง: มีการส่ง texture_image_urls พร้อมกับ ai_model เป็น meshy-6 หรือ meshy-6-lite เว้นแต่ texture_model จะเป็น meshy-7 หรือ meshy-n1
- URL เข้าถึงไม่ได้: Meshy ไม่สามารถดาวน์โหลดรูปภาพใน image_urls หรือ texture_image_urls ได้
- รูปภาพใหญ่เกินไป: รูปภาพใน image_urls, texture_image_url, หรือ texture_image_urls มีขนาดเกิน 20 MB
- ขนาดรูปภาพไม่ถูกต้อง: รูปภาพใน image_urls, texture_image_url, หรือ texture_image_urls มีด้านที่สั้นกว่า 32 พิกเซล หรือมีมากกว่า 178,956,970 พิกเซล (กว้าง × สูง)
- ความละเอียดไม่รองรับสำหรับอินพุตหลายรูปภาพ: geometry_resolution เป็น "4k" ซึ่งเอนด์พอยต์นี้ไม่รองรับ ให้ใช้ 2k หรือ standard
- โมเดลไม่รองรับสำหรับตัวเลือกรูปภาพ: มีการส่ง image_enhancement พร้อมกับ ai_model: "meshy-6-lite" หรือมีการส่ง remove_lighting พร้อมกับ ai_model: "meshy-6-lite" และโมเดลเท็กซ์เจอร์เริ่มต้นของมัน
- โมเดลเท็กซ์เจอร์ไม่ถูกต้อง: texture_model ไม่ใช่ชื่อโมเดลเท็กซ์เจอร์ที่ถูกต้อง
- โมเดลเท็กซ์เจอร์ไม่พร้อมใช้งาน: คำขอที่มีเท็กซ์เจอร์ส่ง texture_model เป็น meshy-6 หรือ meshy-6-lite หลายรูปเป็น 3D รองรับเฉพาะโมเดลเท็กซ์เจอร์ที่ทำเท็กซ์เจอร์จากหลายมุมมองเท่านั้น ให้ส่ง meshy-7 หรือ meshy-n1 หรือไม่ต้องระบุ texture_model
- ตัวเลือกไม่รองรับสำหรับโมเดลเท็กซ์เจอร์: คำขอขอให้โมเดลเท็กซ์เจอร์ใช้ตัวเลือกที่ไม่รองรับ เช่น enable_pbr: true กับ meshy-n1 หรือเท็กซ์เจอร์ 4k กับ meshy-6-lite ดู โมเดล
แก้ไขคำขอ แล้วส่งใหม่อีกครั้ง ดู ข้อผิดพลาด
Name
401 - Unauthorized
Description
API คีย์หายไปหรือไม่ถูกต้อง ตรวจสอบส่วนหัว Authorization
Name
402 - Payment Required
Description
ตัวอย่างเช่น:
- เครดิตไม่เพียงพอ: บัญชีมีเครดิตไม่เพียงพอสำหรับงานนี้ หรือบัญชีถึงขีดจำกัดเครดิตแล้ว ตรวจสอบยอดคงเหลือเครดิตของคุณ แล้วลองใหม่
- แผนฟรี: การสร้างงานต้องใช้แผนแบบชำระเงิน อัปเกรดแผนของคุณในการตั้งค่าการสมัครสมาชิก แล้วลองใหม่
Name
403 - Forbidden
Description
การตรวจสอบเนื้อหาได้บล็อก prompt หรือรูปภาพอินพุต เปลี่ยนอินพุต แล้วลองใหม่
Name
404 - Not Found
Description
input_task_id ไม่ตรงกับงานใด ๆ ของคุณ ตรวจสอบ ID ของงาน แล้วส่งคำขออีกครั้ง
Name
429 - Too Many Requests
Description
คุณเกินการจำกัดอัตราแล้ว กรุณารอสักครู่ แล้วลองใหม่ ดู การจำกัดอัตรา

GET/openapi/v1/multi-image-to-3d/:id

ดึงข้อมูลงานหลายรูปเป็น 3D

ส่งคืนงานหลายรูปเป็น 3D ตามรหัส ID ของงานนั้น

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

พารามิเตอร์

Name
id
Type
path
Description
รหัสงาน (task ID) จากการตอบกลับของการสร้าง

ผลลัพธ์ที่ส่งคืน

ออบเจ็กต์งานหลายรูปเป็น 3D

DELETE/openapi/v1/multi-image-to-3d/:id

ลบงานหลายรูปเป็น 3D

ลบงานหลายรูปเป็น 3D อย่างถาวร รวมถึงโมเดลและข้อมูลของงานนั้น คุณไม่สามารถยกเลิกการลบได้

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

พารามิเตอร์พาธ

Name
id
Type
path
Description
ID ของงานที่ต้องการลบ

สถานะงาน

การลบงานที่มีสถานะ PENDING จะคืนเครดิตที่ใช้ไปตอนสร้างงานนั้น

งานที่มีสถานะ IN_PROGRESS ไม่สามารถลบได้ คำขอจะคืนค่า 409 Conflict และงานจะยังคงทำงานต่อไป Meshy ไม่คืนเครดิตให้กับงานที่เริ่มทำงานไปแล้ว ดังนั้นการลบงานนั้นจะทำให้คุณเสียทั้งเครดิตและผลลัพธ์ ให้รอจนกว่างาน จะถึงสถานะ SUCCEEDED, FAILED หรือ CANCELED จากนั้นจึงลบงานนั้น

การลบงานที่อยู่ในสถานะสุดท้าย (SUCCEEDED, FAILED หรือ CANCELED) จะไม่คืนเครดิต

ค่าที่ส่งกลับ

200 OK เมื่อลบงานสำเร็จ หรือ 409 Conflict เมื่องานมีสถานะ IN_PROGRESS

GET/openapi/v1/multi-image-to-3d

รายการงาน หลายรูปเป็น 3D

คืนค่ารายการงาน หลายรูปเป็น 3D ของคุณ

Request

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": null,

    "consumed_credits": 30
  }
]

พารามิเตอร์

Name
page_num
Type
integer
ค่าเริ่มต้น 1
Description
หมายเลขหน้าที่ต้องการคืนค่า สูงสุด 255 หากใส่ค่าที่มากกว่านี้จะคืนค่า 400
Name
page_size
Type
integer
ค่าเริ่มต้น 10
Description
จำนวนงานต่อหน้า สูงสุด 100
Name
sort_by
Type
string
Description
ลำดับการเรียง
ค่าที่ใช้ได้:
- +created_at: เก่าสุดก่อน
- -created_at: ใหม่สุดก่อน

คืนค่า

รายการแบบแบ่งหน้าของ อ็อบเจกต์งาน หลายรูปเป็น 3D

GET/openapi/v1/multi-image-to-3d/:id/stream

สตรีมงาน Multi-Image to 3D

สตรีมการอัปเดตของงาน Multi-Image to 3D ในรูปแบบ Server-Sent Events (SSE)

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
  "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
  "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
  "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

พารามิเตอร์

Name
id
Type
path
Description
ไอดีของงานจากการตอบกลับตอนสร้างงาน

สิ่งที่ส่งกลับ

สตรีมของ ออบเจ็กต์งาน Multi-Image to 3D ในรูปแบบ Server-Sent Events

แต่ละอีเวนต์จะมีออบเจ็กต์งานฉบับเต็ม ในรูปแบบเดียวกับที่เอนด์พอยต์ Get ส่งกลับมา ในขณะที่งานยังอยู่ในสถานะ PENDING หรือ IN_PROGRESS ฟิลด์ผลลัพธ์ของงานจะยังไม่มีค่า

อ็อบเจ็กต์งาน Multi-Image to 3D

อ็อบเจ็กต์งาน Multi-Image to 3D อธิบายการสร้างโมเดล 3D หนึ่งครั้งจากภาพของวัตถุหนึ่งถึงสี่ภาพ โดยเก็บสถานะ progress และไฟล์โมเดลเมื่องานสำเร็จ

Properties

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": null,

  "consumed_credits": 30
}

Name
id
Type
string
Description
รหัสงาน ให้ถือว่าเป็นสตริงทึบ (opaque string) และอย่าอ้างอิงรูปแบบของมัน
Name
type
Type
string
Description
ประเภทของงาน ซึ่งเป็น multi-image-to-3d เสมอ
Name
model_urls
Type
object
Description
URL สำหรับดาวน์โหลดโมเดล 3D ที่สร้างขึ้น หนึ่ง URL ต่อหนึ่งรูปแบบไฟล์ รูปแบบที่งานไม่ได้สร้างจะไม่มีคีย์นั้นปรากฏอยู่ แทนที่จะเป็นสตริงว่าง
- Name
  glb
  Type
  string
  Description
  ไฟล์ GLB
- Name
  fbx
  Type
  string
  Description
  ไฟล์ FBX
- Name
  obj
  Type
  string
  Description
  ไฟล์ OBJ
- Name
  usdz
  Type
  string
  Description
  ไฟล์ USDZ
- Name
  mtl
  Type
  string
  Description
  ไฟล์ MTL ซึ่งจะส่งคืนมาพร้อมกับไฟล์ OBJ เมื่อโมเดลมีเท็กซ์เจอร์
- Name
  stl
  Type
  string
  Description
  ไฟล์ STL
- Name
  3mf
  Type
  string
  Description
  ไฟล์ 3MF จะปรากฏเฉพาะเมื่อ target_formats มี 3mf รวมอยู่ด้วย
- Name
  pre_remeshed_glb
  Type
  string
  Description
  ไฟล์ GLB จากก่อนการรีเมช จะปรากฏเฉพาะเมื่อคุณสร้างงานโดยกำหนดทั้ง should_remesh: true และ save_pre_remeshed_model: true
Name
thumbnail_url
Type
string
Description
URL สำหรับดาวน์โหลดภาพตัวอย่างของโมเดล ซึ่งจะเหมือนกับ thumbnail_urls.front เมื่อฟิลด์นั้นปรากฏอยู่
Name
alpha_thumbnail_url
Type
string
Description
URL สำหรับดาวน์โหลดเวอร์ชันของ thumbnail_url ที่มีพื้นหลังโปร่งใส (RGBA) จะปรากฏเฉพาะเมื่อคุณสร้างงานโดยกำหนด alpha_thumbnail: true และ Meshy เรนเดอร์ภาพตัวอย่างแบบโปร่งใสแล้ว
Name
thumbnail_urls
Type
object
Description
URL สำหรับดาวน์โหลดภาพตัวอย่างของโมเดล 3D จากสี่ด้าน แต่ละ URL เป็น signed URL ของภาพ PNG ขนาด 512×512 ที่เรนเดอร์ด้วยวัสดุและแสงแบบเดียวกับ thumbnail_url คุณสามารถใช้ภาพเหล่านี้เพื่อดูตัวอย่างโมเดลจากหลายมุมโดยไม่ต้องดาวน์โหลดไฟล์ GLB
จะปรากฏเฉพาะเมื่อคุณสร้างงานโดยกำหนด multi_view_thumbnails: true และงานมีสถานะถึง SUCCEEDED แล้ว งานที่สร้างโดยไม่กำหนด multi_view_thumbnails: true จะไม่มีฟิลด์นี้
- Name
  front
  Type
  string
  Description
  มุมมองด้านหน้า ที่ 0° รอบแกนแนวตั้ง ตรงกับ thumbnail_url
- Name
  right
  Type
  string
  Description
  มุมมองด้านขวา ที่ 90°
- Name
  back
  Type
  string
  Description
  มุมมองด้านหลัง ที่ 180°
- Name
  left
  Type
  string
  Description
  มุมมองด้านซ้าย ที่ 270°
Name
texture_prompt
Type
string
Description
prompt ข้อความที่ใช้ชี้นำเท็กซ์เจอร์
Name
texture_image_urls
Type
string[]
Description
URL สำหรับดาวน์โหลดภาพอ้างอิงเท็กซ์เจอร์ที่คุณใช้สร้างงาน ตามลำดับที่คุณส่งเข้ามา จะปรากฏเฉพาะเมื่อคุณสร้างงานโดยกำหนด texture_image_urls
Name
ultra_mode
Type
boolean
⚠ เลิกใช้แล้ว
Description
ให้อ่าน geometry_resolution แทน
Name
geometry_resolution
Type
string
Description
ระดับ Ultra ที่งานรัน ซึ่งคือ 2k งานแบบ standard จะไม่มีฟิลด์นี้
Name
progress
Type
integer
Description
งานเสร็จไปเท่าไหร่แล้ว เป็นเปอร์เซ็นต์ โดยเป็น 0 จนกว่างานจะเริ่ม และเป็น 100 เมื่อสำเร็จ
Name
started_at
Type
timestamp
Description
เวลาที่งานเริ่มต้น เป็นหน่วยมิลลิวินาทีแบบ Unix โดยเป็น 0 จนกว่างานจะเริ่ม
Name
created_at
Type
timestamp
Description
เวลาที่สร้างงาน เป็นหน่วยมิลลิวินาทีแบบ Unix
Name
expires_at
Type
timestamp
Description
เวลาที่ผลลัพธ์ของงานจะหมดอายุ เป็นหน่วยมิลลิวินาทีแบบ Unix
Name
finished_at
Type
timestamp
Description
เวลาที่งานเสร็จสิ้น เป็นหน่วยมิลลิวินาทีแบบ Unix โดยเป็น 0 จนกว่างานจะเสร็จสิ้น
Name
status
Type
string
Description
สถานะของงาน หนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED, หรือ CANCELED
Name
texture_urls
Type
array
Description
URL สำหรับดาวน์โหลดแมปเท็กซ์เจอร์ที่งานสร้างขึ้น เป็นอาร์เรย์ของอ็อบเจ็กต์ ซึ่งมักจะมีอ็อบเจ็กต์เดียว แต่ละอ็อบเจ็กต์มีฟิลด์เหล่านี้:
- Name
  base_color
  Type
  string
  Description
  แมปสีพื้นฐาน (base color)
- Name
  metallic
  Type
  string
  Description
  แมปความเป็นโลหะ (metallic) จะไม่รวมอยู่ด้วยเมื่อคุณสร้างงานโดยกำหนด enable_pbr: false
- Name
  normal
  Type
  string
  Description
  นอร์มัลแมป จะไม่รวมอยู่ด้วยเมื่อคุณสร้างงานโดยกำหนด enable_pbr: false
- Name
  roughness
  Type
  string
  Description
  แมปความขรุขระ (roughness) จะไม่รวมอยู่ด้วยเมื่อคุณสร้างงานโดยกำหนด enable_pbr: false
- Name
  emission
  Type
  string
  Description
  แมปการเปล่งแสง (emission) จะรวมอยู่ด้วยเฉพาะเมื่อคุณสร้างงานโดยมีเงื่อนไขทั้งหมดนี้:
  
  ai_model: meshy-6 พร้อมโมเดลเท็กซ์เจอร์เริ่มต้นของมัน
  
  enable_pbr: true
  
  texture_resolution เป็น 2k หรือ 4k
Name
preceding_tasks
Type
integer
Description
จำนวนงานที่อยู่ก่อนหน้างานนี้ในคิว ค่านี้มีความหมายเฉพาะขณะที่งานอยู่ในสถานะ PENDING เท่านั้น
Name
task_error
Type
object
Description
รายละเอียดข้อผิดพลาดเมื่องานล้มเหลว โดยเป็น null ยกเว้นเมื่อสถานะเป็น FAILED ดู ข้อผิดพลาด
Name
consumed_credits
Type
integer
Description
จำนวนเครดิตที่งานนี้ใช้ไป จะปรากฏเมื่อสถานะเป็น PENDING, IN_PROGRESS, หรือ SUCCEEDED โดยเป็น 0 สำหรับงานที่ FAILED เนื่องจาก Meshy จะคืนเครดิตให้เมื่องานล้มเหลว