Remesh API

สร้างเมชของโมเดล 3D ขึ้นใหม่ด้วย topology และจำนวนหน้าใหม่ และส่งออกในรูปแบบที่คุณเลือก โมเดลสามารถมาจากงาน Meshy อื่น เช่น รูปภาพเป็น 3D หรือข้อความเป็น 3D หรือจากไฟล์โมเดล

POST/openapi/v1/remesh

สร้างงานรีเมช

สร้างงานรีเมช งานนี้ทำงานในเบื้องหลัง สำหรับระยะเวลาที่งานมักใช้ โปรดดู ระยะเวลาในการประมวลผล

หากต้องการแปลงรูปแบบของโมเดลหรือปรับขนาดโมเดล ให้ใช้ Convert API หรือ Resize API พารามิเตอร์ที่เลิกใช้ในหน้านี้ยังคงทำงานได้ แต่การเชื่อมต่อใหม่ควรใช้เอนด์พอยต์เหล่านั้นแทน

Request

POST

/openapi/v1/remesh

# Basic remesh with custom formats and resize
curl https://api.meshy.ai/openapi/v1/remesh \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "target_formats": ["glb", "fbx"],
    "topology": "quad",
    "target_polycount": 50000,
    "resize_height": 1.0,
    "origin_at": "bottom"
  }'

# Quad remesh with auto-size
curl https://api.meshy.ai/openapi/v1/remesh \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "target_formats": ["glb", "fbx"],
    "topology": "quad",
    "target_polycount": 50000,
    "auto_size": true
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

พารามิเตอร์

Name
input_task_id
Type
string
จำเป็น
Description
จำเป็นต้องระบุ เว้นแต่คุณจะส่ง model_url ไอดีของงานที่มีโมเดลซึ่งคุณต้องการรีเมช เช่น งานข้อความเป็น 3D, รูปภาพเป็น 3D, รีเท็กซ์เจอร์ หรือรีเมช งานนั้นต้องเป็นงานที่คุณสร้างด้วย API และมีสถานะ SUCCEEDED

Name
model_url
Type
string
จำเป็น
Description
จำเป็นต้องระบุ เว้นแต่คุณจะส่ง input_task_id โมเดลที่จะรีเมช ในรูปแบบ URL สาธารณะหรือ data URI หากคุณส่งทั้งสองอย่าง Meshy จะใช้ input_task_id
โมเดลต้องเป็นไฟล์ GLB, glTF, OBJ, FBX หรือ STL ขนาดไม่เกิน 400 MB จาก URL แบบ http หรือ https หรือไม่เกิน 100 MB ในรูปแบบ data URI สำหรับ data URI ให้ใช้ MIME type application/octet-stream
ไฟล์ที่มีขนาดเกิน 100 MB ต้องเป็นไปตามกฎเหล่านี้ด้วย:
- ไฟล์ GLB, glTF, FBX หรือ OBJ สามารถมีหน้าได้สูงสุด 10,000,000 หน้า Meshy นับหน้าเป็นสามเหลี่ยม ดังนั้นรูปสี่เหลี่ยมจะนับเป็น 2 และเมชที่ถูกวาดมากกว่าหนึ่งครั้งจะนับหนึ่งครั้งต่อสำเนา
- ไฟล์ FBX ต้องเป็นไบนารี FBX 7.1 หรือใหม่กว่า
- ไฟล์ GLB หรือ glTF ต้องไม่ใช้การบีบอัดแบบ Draco

Name
target_formats
Type
string[]
ค่าเริ่มต้น ["glb"]
Description
รูปแบบไฟล์ที่จะสร้าง
ค่าที่ใช้ได้:
- glb
- fbx
- obj
- usdz
- blend
- stl
- 3mf
Name
topology
Type
string
ค่าเริ่มต้น triangle
Description
ประเภทหน้าของโมเดลที่ผ่านการรีเมช
ค่าที่ใช้ได้:
- quad: เมชที่ส่วนใหญ่เป็นรูปสี่เหลี่ยม
- triangle: เมชสามเหลี่ยมที่ลดจำนวนหน้าแล้ว
Name
target_polycount
Type
integer
ค่าเริ่มต้น 30000
Description
จำนวนหน้าที่ต้องการ ตั้งแต่ 100 ถึง 300000 ผลลัพธ์อาจแตกต่างจากเป้าหมาย ขึ้นอยู่กับจีออเมทรีของโมเดล ค่าที่อยู่นอกช่วงจะคืนค่า 400
Name
decimation_mode
Type
integer
Description
จำนวนหน้าแบบปรับได้ ตามระดับ เมื่อคุณตั้งค่านี้ Meshy จะไม่สนใจ target_polycount
ค่าที่ใช้ได้:
- 1: อัลตร้า
- 2: สูง
- 3: กลาง
- 4: ต่ำ
Name
resize_height
Type
number
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น 0
Description
ใช้ Resize API แทน ความสูงที่จะปรับขนาดโมเดล หน่วยเป็นเมตร ส่งได้อย่างมากหนึ่งค่าจาก resize_height, resize_longest_side, และ auto_size
Name
resize_longest_side
Type
number
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น 0
Description
ใช้ Resize API แทน ความยาวที่จะปรับขนาดด้านที่ยาวที่สุดของกล่องขอบเขตของโมเดล หน่วยเป็นเมตร ส่งได้อย่างมากหนึ่งค่าจาก resize_height, resize_longest_side, และ auto_size
Name
auto_size
Type
boolean
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น false
Description
ใช้ Resize API แทน ว่าจะให้ประมาณความสูงจริงของวัตถุด้วย AI vision แล้วปรับขนาดโมเดลให้เท่ากันหรือไม่ ส่งได้อย่างมากหนึ่งค่าจาก resize_height, resize_longest_side, และ auto_size
Name
origin_at
Type
string
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น bottom
Description
ใช้ Resize API แทน ตำแหน่งที่จะวางจุดกำเนิดของโมเดล bottom หรือ center ค่าเริ่มต้นจะมีผลเมื่อคุณส่ง resize_height, resize_longest_side, หรือ auto_size หากไม่มีการส่งค่าเหล่านี้ Meshy จะย้ายจุดกำเนิดก็ต่อเมื่อคุณส่ง origin_at

Name
convert_format_only
Type
boolean
⚠ เลิกใช้แล้ว
Description
ใช้ Convert API แทน ว่าจะแปลงโมเดลเป็น target_formats เท่านั้นหรือไม่ เมื่อเป็น true Meshy จะไม่สนใจ topology, target_polycount, decimation_mode, resize_height, resize_longest_side, และ auto_size แต่ยังคงตรวจสอบค่าของพารามิเตอร์เหล่านั้น ดังนั้นค่าที่ไม่ถูกต้องจะคืนค่า 400 เมื่อใช้ convert_format_only: true หาก target_formats ว่างเปล่าหรือเป็น null จะคืนค่า 400

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

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

ฟิลด์ result ของการตอบกลับมีไอดีของงานรีเมชใหม่

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

Name
400 - Bad Request
Description
คำขอนี้ไม่สามารถทำงานได้ ข้อความแสดงข้อผิดพลาดจะระบุปัญหาที่พบ ตัวอย่างเช่น:
- ขาดพารามิเตอร์: ไม่ได้ส่งทั้ง model_url และ input_task_id
- งานต้นทางไม่ถูกต้อง: input_task_id ไม่ใช่งาน API ที่สำเร็จ หรือโมเดล AI ของงานนั้นไม่รองรับการรีเมช
- รูปแบบโมเดลไม่ถูกต้อง: ไฟล์ model_url มีนามสกุลที่ไม่รองรับ
- URL ไม่สามารถเข้าถึงได้: Meshy ไม่สามารถดาวน์โหลดไฟล์ model_url ได้
- ไฟล์โมเดลมีขนาดใหญ่เกินไป: ไฟล์ model_url มีขนาดเกิน 400 MB จาก URL แบบ http หรือ https หรือเกิน 100 MB ในรูปแบบ data URI
- มีหน้าจำนวนมากเกินไป: ไฟล์ model_url มีขนาดเกิน 100 MB และมีหน้ามากกว่า 10,000,000 หน้า ลดจำนวนหน้าแล้วส่งไฟล์อีกครั้ง
- ASCII FBX เกิน 100 MB: ไฟล์ model_url เป็น ASCII FBX ที่มีขนาดเกิน 100 MB ให้ส่งเป็นไบนารี FBX หรือ GLB แทน
- ไม่สามารถอ่านไฟล์โมเดลได้: ไฟล์ model_url มีขนาดเกิน 100 MB และ Meshy ไม่สามารถอ่านส่วนหัวของไฟล์ได้ เช่น เป็น GLB หรือ glTF ที่บีบอัดแบบ Draco หรือเป็นไบนารี FBX ที่เก่ากว่า 7.1
- ส่วนหัวของโมเดลซับซ้อนเกินไป: ไฟล์ model_url มีขนาดเกิน 100 MB และส่วนหัวมีเมช โหนด หรือเรคคอร์ดมากเกินไปที่จะตรวจสอบ ลดจำนวนออบเจ็กต์ในไฟล์แล้วส่งอีกครั้ง
- topology ไม่ถูกต้อง: topology ไม่ใช่ quad หรือ triangle
- พารามิเตอร์ที่ขัดแย้งกัน: คำขอมีมากกว่าหนึ่งค่าจาก auto_size, resize_height, และ resize_longest_side ให้ส่งเพียงค่าเดียว
แก้ไขคำขอแล้วส่งอีกครั้ง ดู ข้อผิดพลาด
Name
401 - Unauthorized
Description
ไม่มี API คีย์หรือ API คีย์ไม่ถูกต้อง ตรวจสอบเฮดเดอร์ Authorization
Name
402 - Payment Required
Description
ตัวอย่างเช่น:
- เครดิตไม่เพียงพอ: บัญชีมีเครดิตไม่เพียงพอสำหรับงานนี้ หรือบัญชีถึงขีดจำกัดเครดิตแล้ว ตรวจสอบยอดคงเหลือเครดิตของคุณ แล้วลองใหม่
- แผนฟรี: การสร้างงานต้องใช้แผนแบบชำระเงิน อัปเกรดแผนของคุณในการตั้งค่าการสมัครสมาชิก แล้วลองใหม่
Name
403 - Forbidden
Description
input_task_id เป็นโมเดลแบบบาสรีลีฟ ซึ่งเอนด์พอยต์นี้ไม่สามารถรีเมชได้ ข้อความคือ This model type does not support this operation ให้ส่งโมเดลอื่นแทน
Name
404 - Not Found
Description
input_task_id ไม่ตรงกับงานใดๆ ของคุณ ตรวจสอบไอดีงานแล้วส่งคำขออีกครั้ง
Name
429 - Too Many Requests
Description
คุณเกินการจำกัดอัตราของคุณแล้ว รอสักครู่แล้วลองใหม่ ดู การจำกัดอัตรา

GET/openapi/v1/remesh/:id

ดึงข้อมูลงาน Remesh

คืนค่างาน Remesh ตามรหัส ID ของงานนั้น

Request

GET

/openapi/v1/remesh/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl https://api.meshy.ai/openapi/v1/remesh/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "remesh",
  "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.usdz?Expires=***",
      "blend": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.blend?Expires=***",
      "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
},
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null
}

พารามิเตอร์

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

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

ออบเจ็กต์งาน Remesh

DELETE/openapi/v1/remesh/:id

ลบงานรีเมช

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

Request

DELETE

/openapi/v1/remesh/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/remesh/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -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."
}

Path parameters

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

สถานะของงาน

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

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

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

Returns

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

GET/openapi/v1/remesh

แสดงรายการงานรีเมช

ส่งคืนรายการงานรีเมชของคุณ

Request

GET

/openapi/v1/remesh

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "remesh",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.usdz?Expires=***",
      "blend": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.blend?Expires=***",
      "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "task_error": null
  }
]

พารามิเตอร์

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: ใหม่สุดก่อน

ส่งคืนค่า

รายการแบบแบ่งหน้าของ อ็อบเจกต์งานรีเมช

GET/openapi/v1/remesh/:id/stream

สตรีมงานรีเมช

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

Request

GET

/openapi/v1/remesh/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream

curl -N https://api.meshy.ai/openapi/v1/remesh/a43b5c6d-7e8f-901a-234b-567c890d1e2f/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": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "remesh",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.usdz?Expires=***",
    "blend": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.blend?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
}

พารามิเตอร์

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

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

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

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

The Remesh task object

อ็อบเจกต์งาน Remesh อธิบายการรีเมชโมเดล 3D หนึ่งครั้ง โดยจะเก็บสถานะ progress และไฟล์โมเดลเมื่องานสำเร็จ

คุณสมบัติ

Example Remesh Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "remesh",
  "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.usdz?Expires=***",
      "blend": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.blend?Expires=***",
      "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 5
}

Name
id
Type
string
Description
ไอดีของงาน ให้ถือว่าเป็นสตริงที่ไม่มีความหมายตายตัว และอย่าอ้างอิงรูปแบบของมัน
Name
type
Type
string
Description
ประเภทของงาน ซึ่งจะเป็น remesh เสมอ
Name
model_urls
Type
object
Description
URL สำหรับดาวน์โหลดโมเดลที่รีเมชแล้ว หนึ่ง 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
  blend
  Type
  string
  Description
  ไฟล์ Blender
- Name
  stl
  Type
  string
  Description
  ไฟล์ STL
- Name
  3mf
  Type
  string
  Description
  ไฟล์ 3MF จะปรากฏเฉพาะเมื่อ target_formats รวม 3mf ไว้ด้วย
Name
thumbnail_url
Type
string
Description
URL สำหรับดาวน์โหลดภาพตัวอย่างของโมเดลที่รีเมชแล้ว
Name
alpha_thumbnail_url
Type
string
Description
URL สำหรับดาวน์โหลดเวอร์ชันของ thumbnail_url ที่มีพื้นหลังโปร่งใส (RGBA) จะปรากฏเฉพาะเมื่อคุณสร้างงานด้วย alpha_thumbnail: true และ Meshy เรนเดอร์ภาพตัวอย่างแบบโปร่งใสแล้ว
Name
progress
Type
integer
Description
งานเสร็จไปแล้วเท่าไร แสดงเป็นเปอร์เซ็นต์ โดยจะเป็น 0 จนกว่างานจะเริ่ม และเป็น 100 เมื่องานสำเร็จ
Name
status
Type
string
Description
สถานะของงาน ซึ่งเป็นหนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED หรือ CANCELED
Name
preceding_tasks
Type
integer
Description
จำนวนงานที่อยู่ข้างหน้างานนี้ในคิว ค่านี้มีความหมายก็ต่อเมื่องานยังอยู่ในสถานะ PENDING
Name
created_at
Type
timestamp
Description
เวลาที่สร้างงาน หน่วยเป็นมิลลิวินาทีแบบ Unix
Name
started_at
Type
timestamp
Description
เวลาที่งานเริ่ม หน่วยเป็นมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่างานจะเริ่ม
Name
finished_at
Type
timestamp
Description
เวลาที่งานเสร็จสิ้น หน่วยเป็นมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่างานจะเสร็จสิ้น
Name
expires_at
Type
timestamp
Description
เวลาที่ URL สำหรับดาวน์โหลดของงานจะหมดอายุ หน่วยเป็นมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่างานจะเสร็จสิ้น
Name
texture_urls
Type
array
Description
URL สำหรับดาวน์โหลดเท็กซ์เจอร์แมปของโมเดล เมื่องานสำเร็จ: เป็นอาร์เรย์ของอ็อบเจกต์ หนึ่งอ็อบเจกต์ต่อหนึ่งชุดเท็กซ์เจอร์ แต่ละอ็อบเจกต์จะมี URL ของ base_color และอาจมี URL ของ metallic, roughness, normal, emission และ metallic_roughness ด้วย โดยจะเป็น null จนกว่างานจะสำเร็จ และเป็นอาร์เรย์ว่างเมื่อโมเดลไม่มีเท็กซ์เจอร์แมป
Name
task_error
Type
object
Description
รายละเอียดข้อผิดพลาดเมื่องานล้มเหลว ดูที่ ข้อผิดพลาด
Name
consumed_credits
Type
integer
Description
จำนวนเครดิตที่งานนี้ใช้ไป จะปรากฏเมื่อสถานะเป็น PENDING, IN_PROGRESS หรือ SUCCEEDED โดยจะเป็น 0 สำหรับงานที่ FAILED เนื่องจาก Meshy จะคืนเครดิตให้เมื่องานล้มเหลว