Retexture API

Retexture API เป็นฟีเจอร์ที่อนุญาตให้คุณรวมความสามารถการรีเท็กซ์เจอร์ของ AI ของ Meshy เข้ากับแอปพลิเคชันของคุณเอง ในส่วนนี้คุณจะพบกับข้อมูลทั้งหมดที่คุณต้องการเพื่อเริ่มต้นใช้งาน API นี้

POST/openapi/v1/retexture

สร้างงานรีเท็กซ์เจอร์

เอนด์พอยต์นี้อนุญาตให้คุณสร้างงานรีเท็กซ์เจอร์ใหม่ อ้างอิงข้อมูลจาก วัตถุงานรีเท็กซ์เจอร์ เพื่อดูคุณสมบัติที่รวมอยู่ในวัตถุงานรีเท็กซ์เจอร์

พารามิเตอร์

ต้องใช้ input_task_id หรือ model_url อย่างใดอย่างหนึ่ง มีความจำเป็นต้องใช้ หากมีการระบุทั้งสองตัว input_task_id จะมีลำดับความสำคัญ

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

Name
model_url
Type
string
จำเป็น
Description
ให้โมเดล 3D แก่ Meshy เพื่อทำการเท็กซ์เจอร์ รูปแบบที่รองรับ: .glb, .gltf, .obj, .fbx, .stl
มีสองวิธีที่จะให้โมเดล:
- URL ที่เข้าถึงได้แบบสาธารณะ: URL ที่สามารถเข้าถึงได้จากอินเทอร์เน็ตสาธารณะ
- Data URI: Data URI ที่ถูกเข้ารหัส base64 ของโมเดล ใช้ MIME type application/octet-stream ตัวอย่าง: data:application/octet-stream;base64,<your base64-encoded model data>

ต้องใช้ข้อมูลการสไตล์อย่างใดอย่างหนึ่งแน่นอน: text_style_prompt, image_style_url, หรือ multiview_image_urls multiview_image_urls ไม่สามารถใช้ร่วมกับอีกสองอย่างได้ หากมีการระบุ text_style_prompt และ image_style_url ทั้งคู่ image_style_url จะมีลำดับความสำคัญ

Name
text_style_prompt
Type
string
จำเป็น
Description
อธิบายสไตล์เท็กซ์เจอร์ที่ต้องการของวัตถุด้วยข้อความ สูงสุด 600 อักขระ

Name
image_style_url
Type
string
จำเป็น
Description
ให้ภาพ 2 มิติช่วยในการกระบวนการเท็กซ์เจอร์ ปัจจุบันรองรับรูปแบบ .jpg, .jpeg, และ .png
มีสองวิธีที่จะให้ภาพ:
- URL ที่เข้าถึงได้แบบสาธารณะ: URL ที่สามารถเข้าถึงได้จากอินเทอร์เน็ตสาธารณะ
- Data URI: Data URI ที่ถูกเข้ารหัส base64 ของภาพ ตัวอย่างของ Data URI: data:image/jpeg;base64,<your base64-encoded image data>
การทำเท็กซ์เจอร์รูปภาพอาจไม่ทำงานอย่างเหมาะสมหากมีความแตกต่างทางจีออเมทรีอย่างมีนัยสำคัญระหว่างแอสเซทต้นฉบับและภาพที่อัปโหลด

Name
multiview_image_urls
Type
string[]
จำเป็น
Description
ให้ภาพจำนวน 1 ถึง 4 ภาพแสดงวัตถุเดียวกันจากมุมมองที่แตกต่างกันเพื่อช่วยในการทำเท็กซ์เจอร์ ภาพแรกคือมุมมองหลัก (ด้านหน้า); ลำดับของมุมมองที่เหลือ (ด้านซ้าย, ด้านหลัง, ด้านขวา) ไม่สำคัญ
แต่ละองค์ประกอบรองรับรูปแบบเดียวกับ image_style_url (URL ที่เข้าถึงได้แบบสาธารณะหรือ Data URI ของ base64, .jpg/.jpeg/.png)
ต้องใช้ ai_model: "meshy-7" (หรือ latest).

Name
ai_model
Type
string
ค่าเริ่มต้น latest
Description
ไอดีของโมเดล AI ที่จะใช้สำหรับการรีเท็กซ์เจอร์ ตัวเลือกที่ใช้ได้: meshy-5, meshy-6, meshy-7, latest (Meshy 7)
Name
enable_original_uv
Type
boolean
ค่าเริ่มต้น false
Description
เก็บเลย์เอาต์ UV ของโมเดลที่มีอยู่แทนที่จะสร้างใหม่
- หากคุณกำลังรีเท็กซ์เจอร์โมเดลที่ Meshy สร้างขึ้นอีกด้วยไอดีงานหรือ model_url ที่ชี้ไปยังเอาท์พุตของ Meshy ตั้งค่าเป็น true เพื่อใช้เลย์เอาต์ที่ถูกปรับให้เหมาะสมอีกครั้ง
- หากคุณกำลังรีเท็กซ์เจอร์โมเดลของบุคคลที่สามที่คุณอัปโหลด ตั้งค่า true เมื่อมี UV ดีที่ต้องการเก็บไว้ หรือปล่อยเป็น false เพื่อให้ Meshy กระจายเลย์เอาต์ UV ใหม่ (ดีที่สุดสำหรับโมเดลที่ขาดการแมป UV อย่างเหมาะสม).
Name
enable_pbr
Type
boolean
ค่าเริ่มต้น false
Description
สร้าง PBR แมป (metallic, roughness, normal) นอกเหนือจากสีพื้นฐาน แผนที่ emission จะถูกรวมเมื่อ ai_model คือ meshy-6 ยกเว้นที่ texture_resolution: 8k. meshy-7 และ latest จะไม่สร้างแผนที่ emission
Name
texture_resolution
Type
string
ค่าเริ่มต้น 2k
Description
ความละเอียดของสีพื้นฐาน One of 2k (2048×2048), 4k (4096×4096), or 8k (8192×8192). ความละเอียดที่สูงขึ้นจะจับรายละเอียดพื้นผิวได้มากขึ้น
4k และ 8k ต้องใช้ ai_model meshy-6, meshy-7 หรือ latest. ที่ 8k ไม่มีแผนที่ emission ที่ถูกสร้าง
Name
hd_texture
Type
boolean
⚠ เลิกใช้แล้ว
ค่าเริ่มต้น false
Description
ใช้ texture_resolution แทน — เท่ากับ texture_resolution: "4k". เมื่อทั้งสองถูกตั้งค่า, texture_resolution จะมีความสำคัญ
Name
remove_lighting
Type
boolean
ค่าเริ่มต้น true
Description
ลบไฮไลต์และเงาจากสีพื้นฐาน, ได้ผลลัพธ์ที่สะอาดขึ้นที่ทำงานได้ดีกว่าในแสงสว่างที่ตั้งขึ้นเอง
รองรับเฉพาะเมื่อ ai_model คือ meshy-6
Name
target_formats
Type
string[]
Description
ระบุว่าสามารถรับรูปแบบไฟล์ 3D ใดได้. เฉพาะรูปแบบที่ร้องขอเท่านั้นที่จะถูกสร้างและส่งกลับ, สามารถลดเวลาการสิ้นสุดของงานได้ เมื่อไม่ได้ระบุ, รูปแบบที่รองรับทั้งหมดจะถูกเพิ่ม
ค่าที่ใช้ได้: glb, obj, fbx, stl, usdz, 3mf
เมื่อไม่ได้ระบุ, รูปแบบทั้งหมดยกเว้น 3mf จะถูกสร้าง 3mf จะรวมเฉพาะเมื่อระบุชัดเจน
Name
alpha_thumbnail
Type
boolean
ค่าเริ่มต้น false
Description
เมื่อกำหนดเป็น true งานจะเรนเดอร์เวอร์ชันโปร่งใส (RGBA) ของภาพย่อและจะถูกส่งกลับเป็น alpha_thumbnail_url ในการตอบสนอง GET ฟิลด์ thumbnail_url ที่มีอยู่จะไม่เปลี่ยนแปลง

การส่งคืน

คุณสมบัติ result ของการตอบสนองจะมีไอดีของงานรีเท็กซ์เจอร์ที่สร้างใหม่

โหมดความล้มเหลว

Name
400 - Bad Request
Description
การร้องขอไม่เป็นที่ยอมรับ สาเหตุทั่วไป:
- พารามิเตอร์ที่ขาดหาย: ต้องมีการระบุ model_url หรือ input_task_id หนึ่งอย่าง
- ขาดสไตล์: ต้องมีการระบุหนึ่งใน text_style_prompt, image_style_url หรือ multiview_image_urls
- ข้อมูลสไตล์ที่ขัดแย้ง: multiview_image_urls ไม่สามารถรวมกับ text_style_prompt หรือ image_style_url
- โมเดลไม่รองรับสำหรับหลายมุมมอง: multiview_image_urls ต้องใช้งาน ai_model: "meshy-7" (หรือ latest).
- โมเดลไม่พร้อมใช้งาน: ai_model: "meshy-7" กำลังเริ่มต้นการเปิดใช้งานอย่างต่อเนื่องและยังไม่เปิดให้ใช้งานในบัญชีของคุณ
- งานนำเข้าไม่ถูกต้อง: input_task_id ต้องอ้างถึงงานที่สำเร็จจากโมเดลที่รองรับ
- รูปแบบโมเดลไม่ถูกต้อง: model_url ชี้ไปที่ไฟล์ที่มีนามสกุลที่ไม่รองรับ
- URL เข้าถึงไม่ได้: ไม่สามารถดาวน์โหลด model_url, image_style_url หรือองค์ประกอบใน multiview_image_urls
Name
401 - Unauthorized
Description
การยืนยันตัวตนล้มเหลว โปรดตรวจสอบ API คีย์ของคุณ
Name
402 - Payment Required
Description
เครดิตไม่เพียงพอสำหรับทำงานนี้
Name
429 - Too Many Requests
Description
คุณเกินการจำกัดอัตรา

Request

POST

/openapi/v1/retexture

# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "image_style_url": "https://cdn.meshy.ai/image/example_image.jpg",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

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

GET/openapi/v1/retexture/:id

ดึงข้อมูลงานรีเท็กซ์เจอร์

เอนด์พอยต์นี้อนุญาตให้คุณดึงข้อมูลงานรีเท็กซ์เจอร์ตามไอดีงานที่ถูกต้อง อ้างอิงข้อมูลจาก วัตถุงานรีเท็กซ์เจอร์ เพื่อดูคุณสมบัติที่รวมอยู่ในวัตถุงานรีเท็กซ์เจอร์

พารามิเตอร์

Name
id
Type
path
Description
ตัวระบุที่ไม่ซ้ำกันสำหรับงานรีเท็กซ์เจอร์ที่จะดึงข้อมูล

การส่งคืน

การตอบสนองจะมีวัตถุงานรีเท็กซ์เจอร์ ดูในส่วน วัตถุงานรีเท็กซ์เจอร์ สำหรับรายละเอียด

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

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

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "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=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "texture_image_url": "",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

DELETE/openapi/v1/retexture/:id

ลบงานรีเท็กซ์เจอร์

เอนด์พอยต์นี้จะทำการลบงานรีเท็กซ์เจอร์ถาวร รวมถึงโมเดลและข้อมูลทั้งหมดที่เกี่ยวข้อง การดำเนินการนี้ไม่สามารถย้อนกลับได้

พารามิเตอร์เส้นทาง

Name
id
Type
path
Description
ไอดีของงานรีเท็กซ์เจอร์ที่จะลบ

การส่งคืน

ส่งคืน 200 OK เมื่อสำเร็จ

Request

DELETE

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

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

Response

// ส่งคืน 200 Ok เมื่อสำเร็จ

GET/openapi/v1/retexture

รายการงานรีเท็กซ์เจอร์

เอนด์พอยต์นี้อนุญาตให้คุณดึงรายการงานรีเท็กซ์เจอร์

พารามิเตอร์

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

การส่งคืน

ส่งคืนรายการที่แบ่งหน้าของ วัตถุงานรีเท็กซ์เจอร์

Request

GET

/openapi/v1/retexture

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "retexture",
    "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=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "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",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

GET/openapi/v1/retexture/:id/stream

สตรีมงานรีเท็กซ์เจอร์

เอนด์พอยต์นี้จะสตรีมการอัปเดตแบบเรียลไทม์สำหรับงานรีเท็กซ์เจอร์โดยใช้ Server-Sent Events (SSE)

พารามิเตอร์

Name
id
Type
path
Description
ตัวระบุที่ไม่ซ้ำกันสำหรับงานรีเท็กซ์เจอร์ที่จะสตรีม

การส่งคืน

ส่งคืนการสตรีมของ วัตถุงานรีเท็กซ์เจอร์ เป็นเหตุการณ์ Server-Sent Events

สำหรับงาน PENDING หรือ IN_PROGRESS สตรีมการตอบสนองจะรวมแค่ฟิลด์ progress และ status ที่จำเป็นเท่านั้น

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

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

Response Stream

// ตัวอย่างเหตุการณ์ข้อผิดพลาด
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// ตัวอย่างเหตุการณ์ Message แสดงการดำเนินการของงาน
// สำหรับงาน PENDING หรือ IN_PROGRESS, สตรีมการตอบสนองจะไม่รวมฟิลด์ทั้งหมด
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "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=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

วัตถุงานรีเท็กซ์เจอร์

วัตถุงานรีเท็กซ์เจอร์คืองานที่ Meshy ใช้ในการสร้างเท็กซ์เจอร์ 3D จากข้อมูลรูปภาพหรือข้อความ โมเดลมีคุณสมบัติดังนี้:

คุณสมบัติ

Name
id
Type
string
Description
ตัวระบุเฉพาะสำหรับงาน ขณะที่เราใช้ UUID ที่จัดเรียงได้ในรูปแบบ k สำหรับ id ของงานตามรายละเอียดการดำเนินการ คุณไม่ควร ทำข้อสันนิษฐานใดๆ เกี่ยวกับรูปแบบของไอดี
Name
type
Type
string
Description
ประเภทของงานรีเท็กซ์เจอร์ ค่าคือ retexture
Name
model_urls
Type
object
Description
URL ดาวน์โหลดไปยังไฟล์โมเดล 3D ที่มีเท็กซ์เจอร์ที่ถูกสร้างขึ้นโดย Meshy
- Name
  glb
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ GLB
- Name
  fbx
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ FBX
- Name
  obj
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ OBJ
- Name
  usdz
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ USDZ
- Name
  mtl
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ MTL ที่คืนมาคู่กับ OBJ เมื่อมีเท็กซ์เจอร์
- Name
  stl
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ STL
- Name
  3mf
  Type
  string
  Description
  URL ดาวน์โหลดไปยังไฟล์ 3MF มีเฉพาะเมื่อมีการร้องขอ 3mf ผ่าน target_formats
Name
text_style_prompt
Type
string
Description
นี้คือ text prompt ที่ใช้ในการสร้างงานเท็กซ์เจอร์
Name
image_style_url
Type
string
Description
นี้คือการนำเข้าภาพที่ใช้ในการสร้างงานเท็กซ์เจอร์
Name
multiview_image_urls
Type
string[]
Description
URL ที่ดาวน์โหลดได้ไปยังภาพอ้างอิงหลายมุมมองที่ใช้ในการสร้างงานเท็กซ์เจอร์ มีเฉพาะเมื่อสร้างงานโดยใช้ multiview_image_urls
Name
thumbnail_url
Type
string
Description
URL ที่ดาวน์โหลดได้ไปยังภาพย่อของไฟล์โมเดล
Name
alpha_thumbnail_url
Type
string
Description
URL ที่ดาวน์โหลดได้ไปยังเวอร์ชันโปร่งใสของ thumbnail_url. มีเฉพาะเมื่อสร้างงานโดยใช้ alpha_thumbnail: true และการแสดงภาพโปร่งใสสำเร็จ; มิฉะนั้นจะไม่มีฟิลด์นี้.
Name
progress
Type
integer
Description
ความคืบหน้าของงาน หากงานยังไม่เริ่มต้น คุณสมบัตินี้จะเป็น 0 เมื่อสำเร็จแล้ว จะกลายเป็น 100
Name
started_at
Type
timestamp
Description
ไทม์สแตมป์ของวันที่เริ่มงานในมิลลิวินาที หากงานยังไม่เริ่มต้น คุณสมบัตินี้จะเป็น 0
ไทม์สแตมป์แทนจำนวนมิลลิวินาทีที่ผ่านไปตั้งแต่ 1 มกราคม 1970 UTC ตาม มาตรฐาน RFC 3339. ตัวอย่างเช่น วันศุกร์ที่ 1 กันยายน 2023 12:00:00 GMT จะมีค่าแทนคือ 1693569600000. นี้ใช้กับ ทุก ไทม์สแตมป์ใน Meshy API.
Name
created_at
Type
timestamp
Description
ไทม์สแตมป์ของวันที่สร้างงานในมิลลิวินาที
Name
expires_at
Type
timestamp
Description
ไทม์สแตมป์ของวันที่งานหมดอายุในมิลลิวินาที
Name
finished_at
Type
timestamp
Description
ไทม์สแตมป์ของวันที่งานสิ้นสุดในมิลลิวินาที หากงานยังไม่สิ้นสุด คุณสมบัตินี้จะเป็น 0
Name
status
Type
string
Description
สถานะของงาน ค่าที่ใช้ได้คือ PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED
Name
texture_urls
Type
array
Description
อาเรย์ของวัตถุ URL เท็กซ์เจอร์ที่ถูกสร้างขึ้นจากงาน โดยทั่วไปจะมีเพียง หนึ่ง วัตถุ URL เท็กซ์เจอร์ แต่ละ URL ของเท็กซ์เจอร์มีคุณสมบัติดังนี้:
- Name
  base_color
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังภาพแผนที่สีพื้นฐาน
- Name
  metallic
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังภาพแผนที่ metallic
  หากสร้างงานด้วย enable_pbr: false, คุณสมบัตินี้จะถูกละ
- Name
  normal
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังภาพนอร์มัลแมป
  หากสร้างงานด้วย enable_pbr: false, คุณสมบัตินี้จะถูกละ
- Name
  roughness
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังภาพแผนที่ roughness
  หากสร้างงานด้วย enable_pbr: false, คุณสมบัตินี้จะถูกละ
- Name
  emission
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังภาพแผนที่ emission
  หากสร้างงานด้วย enable_pbr: false, หรือ ai_model คือ meshy-5, คุณสมบัตินี้จะถูกละ
Name
preceding_tasks
Type
integer
Description
จำนวนของงานก่อนหน้า
คุณสมบัตินี้มีเฉพาะเมื่อสถานะของงานคือ PENDING
Name
task_error
Type
object
Description
รายละเอียดข้อผิดพลาดสำหรับงานที่ล้มเหลว ดู ข้อผิดพลาด สำหรับข้อมูลอ้างอิงของวัตถุ task_error ทั้งหมด
Name
consumed_credits
Type
integer
Description
จำนวนเครดิตที่ถูกใช้โดยงานนี้ มีเมื่อสถานะของงานคือ PENDING, IN_PROGRESS, หรือ SUCCEEDED จะคืนค่า 0 สำหรับงาน FAILED (เครดิตจะถูกคืนเมื่อเกิดความล้มเหลว)

Example Retexture Task Model

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "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=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
  },
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}