lowpoly จะยุติการให้บริการในวันที่ 30 ต.ค. 2569 โปรดเปลี่ยนโมเดลก่อนวันที่เหล่านี้เพื่อหลีกเลี่ยงข้อผิดพลาดของคำขอ ดูการเลิกใช้งานทั้งหมด

Rigging API

เพิ่มโครงกระดูก (อาร์เมเจอร์) ให้กับโมเดล 3D แบบฮิวแมนนอยด์ และผูกเมชเข้ากับโครงกระดูกนั้น เพื่อให้ตัวละครพร้อมสำหรับการใช้แอนิเมชัน หากต้องการใช้แอนิเมชันกับตัวละครที่ผ่านการริกกิ้งแล้ว โปรดดู Animation API

การริกกิ้งจะทำงานได้ดีเฉพาะกับตัวละครฮิวแมนนอยด์มาตรฐาน (สองขา) ที่มีโครงสร้างแขนขาและร่างกายที่ชัดเจนเท่านั้น


POST/openapi/v1/rigging

สร้างงาน Rigging

สร้างงาน Rigging สำหรับโมเดล 3D เมื่องานสำเร็จ จะได้ตัวละครที่มีการ rig แล้วในรูปแบบมาตรฐาน และหากต้องการ ยังรวมแอนิเมชันการเดินและวิ่งพื้นฐานด้วย

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

Rigging ไม่เหมาะกับโมเดลเหล่านี้:

  • เมชที่ไม่มีเท็กซ์เจอร์
  • แอสเซทที่ไม่ใช่รูปร่างมนุษย์
  • แอสเซทรูปร่างมนุษย์ที่มีโครงสร้างแขนขาและร่างกายไม่ชัดเจน

Request

POST
/openapi/v1/rigging
# Rig a model from a URL
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "height_meters": 1.8
  }'

Response

{
  "result": "018b314a-a1b5-716d-c222-2f1776f7f579"
}

พารามิเตอร์

  • Name
    input_task_id
    Type
    string
    จำเป็น
    Description

    จำเป็นต้องระบุ เว้นแต่คุณจะส่ง model_url ไอดีของงานที่คุณต้องการนำโมเดลไปทำ rig Meshy รองรับโมเดลรูปร่างมนุษย์ที่มีเท็กซ์เจอร์

    โมเดลมีจำนวนสามเหลี่ยมได้สูงสุด 380,000 ชิ้น (quad นับเป็น 2) โมเดลที่เกินกว่านี้จะส่งคืน 400 เพื่อให้อยู่ภายใต้ขีดจำกัด ให้รัน Remesh API กับโมเดลก่อน โดยกำหนด target_polycount ไม่เกิน 300000 หรือไม่เกิน 150000 หากใช้ topology: quad

  • Name
    model_url
    Type
    string
    จำเป็น
    Description

    จำเป็นต้องระบุ เว้นแต่คุณจะส่ง input_task_id โมเดลที่จะนำไปทำ rig ในรูปแบบ URL สาธารณะ หรือ data URI หากคุณส่งทั้งสองอย่าง Meshy จะใช้ input_task_id

    โมเดลต้องเป็นไฟล์ GLB (.glb) ขนาดไม่เกิน 400 MB จาก URL แบบ http หรือ https หรือ 100 MB หากเป็น data URI Rigging รองรับโมเดลรูปร่างมนุษย์ที่มีเท็กซ์เจอร์

    โมเดลมีจำนวนสามเหลี่ยมได้สูงสุด 380,000 ชิ้น (quad นับเป็น 2) โมเดลที่เกินกว่านี้จะส่งคืน 400 เพื่อให้อยู่ภายใต้ขีดจำกัด ให้รัน Remesh API กับโมเดลก่อน โดยกำหนด target_polycount ไม่เกิน 300000 หรือไม่เกิน 150000 หากใช้ topology: quad

    ใบหน้าของตัวละครต้องหันไปทางแกน +Z ซึ่งเป็นทิศทางด้านหน้ามาตรฐานของ glTF การประมาณท่าทาง (pose estimation) จะล้มเหลวหากโมเดลหันไปทางแกนอื่น

    ไฟล์ที่มีขนาดเกิน 100 MB ต้องเป็นไปตามกฎเหล่านี้ด้วย:

    • มีจำนวนหน้า (faces) ได้สูงสุด 10,000,000 หน้า ไฟล์ที่เกินกว่านี้จะส่งคืน 400 Meshy นับหน้าเป็นรูปสามเหลี่ยม และเมชที่ถูกวาดมากกว่าหนึ่งครั้งจะนับหนึ่งครั้งต่อสำเนา
    • ต้องไม่ใช้การบีบอัดแบบ Draco
  • Name
    height_meters
    Type
    number
    ค่าเริ่มต้น 1.7
    Description

    ความสูงโดยประมาณของตัวละคร หน่วยเป็นเมตร Meshy ใช้ค่านี้เพื่อปรับขนาดและทำ rig โมเดลให้แม่นยำยิ่งขึ้น ค่าที่เป็นลบจะส่งคืน 400

  • Name
    texture_image_url
    Type
    string
    ⚠ เลิกใช้แล้ว
    Description

    ไม่ต้องใส่ค่านี้เมื่อโมเดลมีเท็กซ์เจอร์เป็นของตัวเองอยู่แล้ว หากไม่ระบุ Meshy จะใช้เท็กซ์เจอร์ที่ฝังอยู่ในไฟล์ model_url หรือเท็กซ์เจอร์ของงานต้นทาง หากคุณส่งค่านี้ ภาพนี้จะกลายเป็นเท็กซ์เจอร์เดียวของโมเดลที่ทำ rig แล้ว และโมเดลจะสูญเสีย PBR แมป

    เท็กซ์เจอร์สี base ที่ทำ UV-unwrap แล้วของโมเดล ในรูปแบบ URL สาธารณะ หรือ data URI ภาพต้องเป็นไฟล์ PNG ขนาดไม่เกิน 20 MB รูปแบบภาพอื่นจะส่งคืน 400

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

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

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

  • Name
    400 - Bad Request
    Description

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

    • Missing parameter: ไม่ได้ส่งทั้ง model_url และ input_task_id
    • Invalid model format: ไฟล์ model_url มีนามสกุลที่ไม่รองรับ รองรับเฉพาะ .glb เท่านั้น
    • Unreachable URL: Meshy ไม่สามารถดาวน์โหลดไฟล์ model_url ได้
    • Model file too large: ไฟล์ model_url มีขนาดเกิน 400 MB จาก URL แบบ http หรือ https หรือเกิน 100 MB หากเป็น data URI
    • Too many faces: ไฟล์ model_url มีขนาดเกิน 100 MB และมีจำนวนหน้ามากกว่า 10,000,000 หน้า ให้ลดจำนวนหน้า แล้วส่งไฟล์อีกครั้ง
    • Unreadable model file: ไฟล์ model_url มีขนาดเกิน 100 MB และ Meshy ไม่สามารถอ่านส่วนหัวของไฟล์ได้ เช่น เป็นไฟล์ GLB ที่บีบอัดด้วย Draco
    • Model header too complex: ไฟล์ model_url มีขนาดเกิน 100 MB และส่วนหัวของไฟล์มีเมช โหนด หรือเรคคอร์ดมากเกินกว่าจะตรวจสอบได้ ให้ลดจำนวนออบเจ็กต์ในไฟล์ แล้วส่งอีกครั้ง
    • Image too large: ภาพ texture_image_url มีขนาดเกิน 20 MB
    • Invalid texture format: ภาพ texture_image_url ไม่ใช่ไฟล์ PNG
    • Invalid height: height_meters เป็นค่าลบ
    • Invalid input task: input_task_id ไม่ได้อ้างอิงถึงงาน API ที่ถูกต้อง
    • Input task not ready: งาน input_task_id ยังไม่ถึงสถานะ SUCCEEDED รอจนกว่างานจะสำเร็จ แล้วลองใหม่
    • Face count exceeded: โมเดลที่ส่งเข้ามามีจำนวนสามเหลี่ยมมากกว่า 380,000 ชิ้น (quad นับเป็น 2) ให้รัน Remesh API กับโมเดลโดยกำหนด target_polycount ไม่เกิน 300000 หรือไม่เกิน 150000 หากใช้ topology: quad ก่อนนำโมเดลไปทำ rig

    แก้ไขคำขอ แล้วส่งอีกครั้ง ดูที่ ข้อผิดพลาด

  • Name
    401 - Unauthorized
    Description

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

  • Name
    402 - Payment Required
    Description

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

    • Insufficient credits: บัญชีมีเครดิตไม่เพียงพอสำหรับงานนี้ หรือบัญชีถึงขีดจำกัดเครดิตแล้ว ตรวจสอบยอดคงเหลือเครดิตของคุณ แล้วลองใหม่
    • Free plan: การสร้างงานต้องใช้แพ็กเกจแบบเสียเงิน อัปเกรดแพ็กเกจของคุณได้ที่การตั้งค่าการสมัครสมาชิก แล้วลองใหม่
  • Name
    403 - Forbidden
    Description

    input_task_id เป็นโมเดลแบบ bas-relief ซึ่งเอนด์พอยต์นี้ไม่สามารถทำ rig ให้ได้ ข้อความคือ This model type does not support this operation โปรดส่งโมเดลอื่น

  • Name
    404 - Not Found
    Description

    Meshy ไม่พบไฟล์ของงาน input_task_id กรณีใดกรณีหนึ่งต่อไปนี้ใช้ได้:

    • Meshy ลบไฟล์ของงานหลังจาก expires_at ของมัน ให้สร้างงานใหม่อีกครั้ง แล้วส่งไอดีของงานนั้น
    • งานนั้นไม่มีไฟล์ใดๆ ที่ rigging ต้องใช้ เช่น ภาพตัวอย่าง (preview image) เช่น งาน Convert ให้ทำ rig กับงานต้นทางของมัน หรือส่งโมเดลเป็น model_url แทน
  • Name
    422 - Unprocessable Entity
    Description

    การประมาณท่าทาง (pose estimation) ล้มเหลว โมเดลอาจไม่ใช่ตัวละครรูปร่างมนุษย์ที่ถูกต้อง โปรดส่งโมเดลของตัวละครรูปร่างมนุษย์ สำหรับ model_url ให้ตรวจสอบด้วยว่าตัวละครหันหน้าไปทางแกน +Z

  • Name
    429 - Too Many Requests
    Description

    คุณเกินการจำกัดอัตราของคุณแล้ว โปรดรอ แล้วลองใหม่ ดูที่ การจำกัดอัตรา


GET/openapi/v1/rigging/:id

Get a Rigging task

คืนค่า Rigging task ตาม ID ที่ระบุ

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}

Parameters

  • Name
    id
    Type
    path
    Description

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

Returns

Rigging task object


DELETE/openapi/v1/rigging/:id

ลบงาน Rigging

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

Request

DELETE
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -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) จะไม่คืนเครดิต

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

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


GET/openapi/v1/rigging

แสดงรายการงาน Rigging

ส่งคืนรายการงาน Rigging ของคุณแบบแบ่งหน้า เรียงจากล่าสุดไปเก่าสุด หากต้องการเลื่อนดูรายการ ให้ใช้ page_num และ page_size

งานที่คุณสร้างผ่าน API จะอยู่ใน API เท่านั้น และจะไม่ปรากฏใน My Assets ในเว็บแอป หากต้องการค้นหางานที่คุณไม่มี ID อีกต่อไป ให้ใช้เอนด์พอยต์นี้

Request

GET
/openapi/v1/rigging
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

GET/openapi/v1/rigging/:id/stream

สตรีมงาน Rigging

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

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream
curl -N https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/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": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: { // Example of a SUCCEEDED task event, with the same fields as the Rigging task object
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/.../Character_output.fbx?...",
    "rigged_character_glb_url": "https://assets.meshy.ai/.../Character_output.glb?...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.glb?...",
      "walking_fbx_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.fbx?...",
      "walking_armature_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin_armature.glb?...",
      "running_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.glb?...",
      "running_fbx_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.fbx?...",
      "running_armature_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin_armature.glb?..."
    }
  }
}

พารามิเตอร์

  • Name
    id
    Type
    path
    Description

    ไอดีของงานจากการตอบกลับของการสร้าง

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

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

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


The Rigging task object

อ็อบเจ็กต์งาน Rigging อธิบายการ rigging ของตัวละครหนึ่งตัว โดยจะเก็บสถานะ progress และไฟล์ผลลัพธ์เมื่องานสำเร็จ

Properties

Example Rigging Task Object

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}
  • Name
    id
    Type
    string
    Description

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

  • Name
    type
    Type
    string
    Description

    ประเภทของงาน ซึ่งเป็น rig เสมอ

  • Name
    status
    Type
    string
    Description

    สถานะของงาน หนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED, หรือ CANCELED

  • Name
    progress
    Type
    integer
    Description

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

  • 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

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

  • Name
    task_error
    Type
    object
    Description

    รายละเอียดข้อผิดพลาดเมื่องานล้มเหลว โดยจะเป็น null ยกเว้นในกรณีที่สถานะเป็น FAILED ดูเพิ่มเติมที่ ข้อผิดพลาด

  • Name
    consumed_credits
    Type
    integer
    Description

    จำนวนเครดิตที่งานนี้ใช้ไป จะปรากฏเมื่อสถานะเป็น PENDING, IN_PROGRESS, หรือ SUCCEEDED และจะเป็น 0 สำหรับงานที่ FAILED เนื่องจาก Meshy จะคืนเครดิตเมื่องานล้มเหลว

  • Name
    result
    Type
    object
    Description

    URL ของไฟล์ผลลัพธ์ จนกว่างานจะสำเร็จ แต่ละ URL จะเป็นสตริงว่าง และ basic_animations จะเป็น null

    • Name
      rigged_character_fbx_url
      Type
      string
      Description

      URL สำหรับดาวน์โหลดตัวละครที่ rig แล้วในรูปแบบไฟล์ FBX

    • Name
      rigged_character_glb_url
      Type
      string
      Description

      URL สำหรับดาวน์โหลดตัวละครที่ rig แล้วในรูปแบบไฟล์ GLB

    • Name
      basic_animations
      Type
      object (optional)
      Description

      URL สำหรับดาวน์โหลดแอนิเมชันเดินและวิ่งเริ่มต้น

      • Name
        walking_glb_url
        Type
        string
        Description
        แอนิเมชันการเดินพร้อมสกิน ในรูปแบบไฟล์ GLB
      • Name
        walking_fbx_url
        Type
        string
        Description
        แอนิเมชันการเดินพร้อมสกิน ในรูปแบบไฟล์ FBX
      • Name
        walking_armature_glb_url
        Type
        string
        Description
        อาร์เมเจอร์ของแอนิเมชันการเดิน ในรูปแบบไฟล์ GLB
      • Name
        running_glb_url
        Type
        string
        Description
        แอนิเมชันการวิ่งพร้อมสกิน ในรูปแบบไฟล์ GLB
      • Name
        running_fbx_url
        Type
        string
        Description
        แอนิเมชันการวิ่งพร้อมสกิน ในรูปแบบไฟล์ FBX
      • Name
        running_armature_glb_url
        Type
        string
        Description
        อาร์เมเจอร์ของแอนิเมชันการวิ่ง ในรูปแบบไฟล์ GLB
  • Name
    preceding_tasks
    Type
    integer
    Description

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