Creative Lab — API ฟิกเกอร์

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

POST /openapi/creative-lab/figure/v1/prototype
POST /openapi/creative-lab/figure/v1/build

POST/openapi/creative-lab/figure/v1/prototype

สร้างงานต้นแบบฟิกเกอร์

สร้างภาพคอนเซปต์สไตล์จิบิหนึ่งภาพจากรูปภาพต้นฉบับ ID งานที่ส่งคืนคือค่าที่คุณส่งเป็น input_task_id ไปยังเอนด์พอยต์การสร้าง โปรดดู ออบเจ็กต์งานต้นแบบฟิกเกอร์ สำหรับโครงสร้างของการตอบกลับ

พารามิเตอร์

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

ค่าที่ส่งคืน

พร็อพเพอร์ตี result ของการตอบกลับประกอบด้วย id งานของงานต้นแบบฟิกเกอร์ที่สร้างขึ้นใหม่ ให้ตรวจสอบสถานะผ่านเอนด์พอยต์ รับข้อมูลงาน หรือสมัครรับข้อมูลจาก สตรีม จนกว่างานจะถึงสถานะ SUCCEEDED จากนั้นส่ง ID นั้นไปยัง เอนด์พอยต์การสร้าง เป็น input_task_id

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

Name
400 - Bad Request
Description
คำขอไม่สามารถยอมรับได้ สาเหตุทั่วไป:
- ขาดพารามิเตอร์: จำเป็นต้องมี image_url
- รูปแบบรูปภาพไม่ถูกต้อง: image_url ที่ระบุไม่ใช่รูปแบบที่รองรับ (.jpg, .jpeg, .png, .webp)
- ขนาดรูปภาพอยู่นอกช่วง: รูปภาพเล็กเกินไป เกินขนาดไฟล์สูงสุด หรือเกินจำนวนพิกเซลสูงสุด
- URL ไม่สามารถเข้าถึงได้: ไม่สามารถดาวน์โหลด image_url ได้ (404 หรือ timeout)
- Data URI ไม่ถูกต้อง: สตริง base64 มีรูปแบบไม่ถูกต้อง
- เนื้อหาถูกทำเครื่องหมาย: รูปภาพอินพุตถูกทำเครื่องหมายโดย NSFW หรือ moderation ด้านทรัพย์สินทางปัญญา
Name
401 - Unauthorized
Description
การยืนยันตัวตนล้มเหลว โปรดตรวจสอบ API คีย์ของคุณ
Name
402 - Payment Required
Description
เครดิตไม่เพียงพอสำหรับทำงานนี้
Name
429 - Too Many Requests
Description
คุณได้เกินการจำกัดอัตราของคุณแล้ว

Request

POST

/openapi/creative-lab/figure/v1/prototype

# Stage 1: generate a chibi-style concept image
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

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

Prototype example

Start with a source portrait, then generate the prototype image used by the build stage.

ภาพพอร์ตเทรตต้นฉบับที่ใช้เป็นอินพุตฟิกเกอร์ของ Creative Lab — Prototype input

ภาพต้นแบบฟิกเกอร์สไตล์จิบิที่สร้างจากรูปภาพต้นฉบับ — Prototype output

POST/openapi/creative-lab/figure/v1/build

สร้างงานบิลด์ฟิกเกอร์

สร้างฟิกเกอร์ 3D แบบมี texture ขั้นสุดท้ายจากงาน prototype ที่สำเร็จแล้ว การบิลด์ใช้ pipeline รูปภาพเป็น 3D เดียวกันกับ รูปภาพเป็น 3D ดังนั้นรูปแบบออบเจ็กต์การตอบกลับและ รายการ URL เอาต์พุตจึงตรงกันทุกประการ โปรดดู ออบเจ็กต์งานบิลด์ฟิกเกอร์ สำหรับ รูปแบบการตอบกลับ

พารามิเตอร์

Name
input_task_id
Type
string
จำเป็น
Description
ID งานของงาน prototype ที่สร้างผ่านเอนด์พอยต์ OpenAPI เดียวกันนี้ งาน prototype ต้องถูกสร้างด้วย API คีย์เดียวกัน ต้องถึงสถานะ SUCCEEDED แล้ว และต้องสร้างรูปภาพตัวเลือกออกมาเพียงหนึ่งรูปเท่านั้น
งาน prototype ที่สร้างผ่านเว็บแอปจะ ไม่ ถูกยอมรับ — เอนด์พอยต์บิลด์ยอมรับเฉพาะงาน prototype ที่สร้างโดย POST /openapi/creative-lab/figure/v1/prototype และจะปฏิเสธแหล่งที่มาอื่นด้วย 404
Name
name
Type
string
Description
ชื่องานแบบไม่บังคับสำหรับใช้แสดงผล สูงสุด 100 อักขระ

ส่งคืน

พร็อพเพอร์ตี result ของการตอบกลับมี id งานของงานบิลด์ฟิกเกอร์ที่สร้างใหม่ ให้ poll เอนด์พอยต์ Get a Task หรือ subscribe ไปยัง stream จนกว่างานจะถึง SUCCEEDED จากนั้นดาวน์โหลด GLB แบบมี texture จาก model_urls.glb (หรือคู่ OBJ + MTL จาก model_urls.obj และ model_urls.mtl หาก pipeline downstream ของคุณต้องการ OBJ)

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

Name
400 - Bad Request
Description
คำขอไม่สามารถยอมรับได้ สาเหตุที่พบบ่อย:
- พารามิเตอร์ขาดหาย: ต้องมี input_task_id
- UUID ไม่ถูกต้อง: input_task_id ไม่ใช่ UUID ที่ถูกต้อง
- งานหลักยังไม่สำเร็จ: งาน prototype ที่อ้างอิงยังไม่ถึง SUCCEEDED
- ไม่มีตัวเลือก: งาน prototype สำเร็จแล้วแต่ไม่ได้สร้างรูปภาพตัวเลือก
Name
401 - Unauthorized
Description
การยืนยันตัวตนล้มเหลว โปรดตรวจสอบ API คีย์ของคุณ
Name
402 - Payment Required
Description
เครดิตไม่เพียงพอสำหรับดำเนินงานนี้
Name
404 - Not Found
Description
งาน prototype ที่อ้างอิงไม่มีอยู่ เป็นของผู้ใช้รายอื่น หรือถูกสร้างผ่านเว็บแอป (เฉพาะงาน prototype ใน API-mode เท่านั้นที่สามารถ chain ไปยังบิลด์ได้)
Name
429 - Too Many Requests
Description
คุณใช้งานเกินการจำกัดอัตราของคุณแล้ว

Request

POST

/openapi/creative-lab/figure/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

Response

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}

Build example

The build task turns the selected prototype image into a downloadable textured 3D model.

ตัวอย่างโมเดลบิลด์ฟิกเกอร์ใน Creative Lab — Build model preview

GET/openapi/creative-lab/figure/v1/(prototype|build)/:id

ดึงข้อมูลงานฟิกเกอร์

ดึงข้อมูลงาน prototype หรือ build โดยใช้ id ของงานที่ถูกต้อง พาธ URL ต้องตรงกับขั้นตอนของงาน — งาน build ที่ถูกดึงผ่าน /prototype/:id จะส่งคืน 404 และในทางกลับกันก็เช่นกัน

ดู ออบเจ็กต์งาน Prototype ของฟิกเกอร์ และ ออบเจ็กต์งาน Build ของฟิกเกอร์ สำหรับ รูปแบบการตอบกลับ

พารามิเตอร์

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

ค่าที่ส่งคืน

การตอบกลับประกอบด้วยออบเจ็กต์งานฟิกเกอร์ รูปแบบขึ้นอยู่กับ ขั้นตอนที่ร้องขอ

Request

GET

/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

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

# Build
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}

DELETE/openapi/creative-lab/figure/v1/(prototype|build)/:id

ลบงานฟิกเกอร์

ยกเลิกงานฟิกเกอร์ หากงานยังคงเป็น PENDING เครดิต ที่ถูกใช้ไป ณ เวลาสร้างจะได้รับการคืน งานที่อยู่ในสถานะ IN_PROGRESS แล้วจะถูกยกเลิกโดยไม่มีการคืนเครดิต (worker อาจกำลัง ใช้แหล่งข้อมูลอยู่แล้ว) งานที่ไปถึงสถานะสิ้นสุดแล้ว (SUCCEEDED, FAILED, CANCELED) ไม่สามารถยกเลิกได้

พาธ URL ต้องตรงกับขั้นตอนของงาน — DELETE บน /prototype/:buildId จะส่งคืน 404

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

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

ส่งคืน

ส่งคืน 204 No Content เมื่อสำเร็จพร้อมเนื้อหาว่าง

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

Name
400 - Bad Request
Description
งานอยู่ในสถานะสิ้นสุดแล้วและไม่สามารถยกเลิกได้
Name
404 - Not Found
Description
งานไม่มีอยู่ เป็นของผู้ใช้รายอื่น หรือขั้นตอนของงานไม่ตรงกับพาธ URL

Request

DELETE

/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

GET/openapi/creative-lab/figure/v1/(prototype|build)/:id/stream

สตรีมงานฟิกเกอร์

สตรีมการอัปเดตแบบเรียลไทม์สำหรับงานฟิกเกอร์ผ่าน Server-Sent Events (SSE) พาธ URL ต้องตรงกับขั้นตอนของงาน — การเปิดสตรีมที่ /prototype/:buildId/stream จะส่งเพย์โหลด event: error เพียงรายการเดียวพร้อม status_code: 404 และปิดสตรีม

พารามิเตอร์

Name
id
Type
path
Description
ตัวระบุเฉพาะสำหรับงานฟิกเกอร์ที่จะสตรีม

การส่งคืน

ส่งคืนสตรีมของออบเจกต์งาน ฟิกเกอร์ Prototype หรือ ฟิกเกอร์ Build ในรูปแบบ Server-Sent Events สำหรับงาน PENDING หรือ IN_PROGRESS สตรีมการตอบกลับ จะมีเฉพาะฟิลด์ progress และ status ที่จำเป็นเท่านั้น

Request

GET

/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream

curl -N https://api.meshy.ai/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 20,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}

GET/openapi/creative-lab/figure/v1/(prototype|build)

แสดงรายการงานฟิกเกอร์

ดึงรายการงานฟิกเกอร์ของคุณแบบมีการแบ่งหน้าสำหรับสเตจเดียว พาธ URL จะเลือกสเตจ — /prototype ส่งคืนงานต้นแบบ; /build ส่งคืนงาน build งานจากสเตจอื่นจะไม่ถูกรวมอยู่ใน การตอบกลับใด ๆ

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

Name
stage
Type
path
จำเป็น
Description
เป็นได้ทั้ง prototype หรือ build คอลเลกชันจะส่งคืนเฉพาะงาน ที่สเตจตรงกับ URL — การดึง /prototype จะไม่ส่งคืน งาน build และในทางกลับกัน

พารามิเตอร์คิวรี

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

ส่งคืน

ส่งคืนรายการแบบมีการแบ่งหน้าของอ็อบเจ็กต์งานตามสเตจ — อาจเป็น อ็อบเจ็กต์งานต้นแบบฟิกเกอร์ เมื่อแสดงรายการ /prototype หรือ อ็อบเจ็กต์งาน build ฟิกเกอร์ เมื่อ แสดงรายการ /build

Request

GET

/openapi/creative-lab/figure/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "creative-lab-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729123456000,
    "started_at": 1729123460000,
    "finished_at": 1729123486000,
    "expires_at": 1729382686000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

ออบเจ็กต์งานต้นแบบฟิกเกอร์

ออบเจ็กต์งานต้นแบบฟิกเกอร์คือหน่วยงานที่ Meshy ติดตามเพื่อ สร้างภาพคอนเซ็ปต์สไตล์จิบิจากภาพถ่ายต้นฉบับ ผลลัพธ์ของ ขั้นตอนนี้จะถูกเชื่อมต่อไปยังขั้นตอนการสร้าง ผ่าน input_task_id

คุณสมบัติ

Name
id
Type
string
Description
ตัวระบุเฉพาะสำหรับงาน แม้ว่าเราจะใช้ UUID แบบ k-sortable สำหรับ id ของงานเป็นรายละเอียดการใช้งานจริง คุณไม่ควรตั้งสมมติฐานใด ๆ เกี่ยวกับรูปแบบของ id
Name
type
Type
string
Description
ประเภทของงาน ค่าคือ creative-lab-figure-prototype
Name
name
Type
string
Description
ชื่องานที่ระบุเมื่อสร้างงาน สตริงว่างหากไม่ได้ระบุชื่อ
Name
status
Type
string
Description
สถานะของงาน ค่าที่เป็นไปได้คือหนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED
Name
progress
Type
integer
Description
progress ของงาน หากงานยังไม่ได้เริ่ม คุณสมบัตินี้จะเป็น 0 เมื่องานสำเร็จแล้ว ค่านี้จะกลายเป็น 100
Name
created_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่สร้างงาน เป็นมิลลิวินาที
ไทม์สแตมป์แสดงจำนวนมิลลิวินาทีที่ผ่านไปตั้งแต่วันที่ 1 มกราคม 1970 UTC ตามมาตรฐาน RFC 3339 ตัวอย่างเช่น วันศุกร์ที่ 1 กันยายน 2023 เวลา 12:00:00 PM GMT จะแสดงเป็น 1693569600000 สิ่งนี้ใช้กับ ไทม์สแตมป์ ทั้งหมด ใน Meshy API
Name
started_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่เริ่มงาน เป็นมิลลิวินาที หากงานยังไม่ได้เริ่ม คุณสมบัตินี้จะเป็น 0
Name
finished_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่งานเสร็จสิ้น เป็นมิลลิวินาที หากงานยังไม่เสร็จสิ้น คุณสมบัตินี้จะเป็น 0
Name
expires_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่ผลลัพธ์ของงานหมดอายุ เป็นมิลลิวินาที
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 (เครดิตจะถูกคืนเมื่อเกิดความล้มเหลว)
Name
image_urls
Type
array of strings
Description
URL ที่ดาวน์โหลดได้สำหรับตัวเลือกภาพแนวคิดที่สร้างโดยงานต้นแบบนี้ ปัจจุบัน API ส่งคืนตัวเลือกเพียงหนึ่งรายการเสมอ ฟิลด์นี้เป็นอาร์เรย์เพื่อให้การปรับปรุงในอนาคตสามารถแสดงตัวเลือกหลายรายการได้โดยไม่ทำให้เกิดการเปลี่ยนแปลงที่ไม่เข้ากัน

Example Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

ออบเจ็กต์งานสร้างฟิกเกอร์

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

คุณสมบัติ

Name
id
Type
string
Description
ตัวระบุที่ไม่ซ้ำสำหรับงานนี้
Name
type
Type
string
Description
ประเภทของงาน ค่าคือ creative-lab-figure-build
Name
name
Type
string
Description
ชื่องานที่ระบุเมื่อสร้างงาน เป็นสตริงว่างหากไม่ได้ระบุชื่อ
Name
status
Type
string
Description
สถานะของงาน ค่าที่เป็นไปได้คือหนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED
Name
progress
Type
integer
Description
progress ของงาน หากงานยังไม่เริ่ม คุณสมบัตินี้จะเป็น 0 เมื่องานสำเร็จแล้ว ค่านี้จะกลายเป็น 100
Name
created_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่สร้างงาน หน่วยเป็นมิลลิวินาที
Name
started_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่เริ่มงาน หน่วยเป็นมิลลิวินาที
Name
finished_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่งานเสร็จสิ้น หน่วยเป็นมิลลิวินาที
Name
expires_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่ผลลัพธ์ของงานหมดอายุ หน่วยเป็นมิลลิวินาที
Name
preceding_tasks
Type
integer
Description
จำนวนงานก่อนหน้า มีความหมายเฉพาะเมื่อสถานะเป็น PENDING
Name
task_error
Type
object
Description
รายละเอียดข้อผิดพลาดสำหรับงานที่ล้มเหลว ดู ข้อผิดพลาด สำหรับข้อมูลอ้างอิงอ็อบเจ็กต์ task_error แบบเต็ม
Name
consumed_credits
Type
integer
Description
จำนวนเครดิตที่งานนี้ใช้ไป ส่งคืน 0 สำหรับงาน FAILED (เครดิตจะถูกคืนเมื่อเกิดความล้มเหลว)
Name
prompt
Type
string
Description
ว่างเสมอสำหรับการสร้างฟิกเกอร์ มีอยู่เพื่อความเข้ากันได้ข้ามเอนด์พอยต์กับโครงสร้าง V2ImageTo3DTaskResponse ที่ใช้ร่วมกันโดย รูปภาพเป็น 3D
Name
negative_prompt
Type
string
Description
ว่างเสมอสำหรับการสร้างฟิกเกอร์ มีอยู่เพื่อความเข้ากันได้ข้ามเอนด์พอยต์
Name
texture_prompt
Type
string
Description
ว่างเสมอสำหรับการสร้างฟิกเกอร์ มีอยู่เพื่อความเข้ากันได้ข้ามเอนด์พอยต์
Name
texture_image_url
Type
string
Description
ว่างเสมอสำหรับการสร้างฟิกเกอร์ มีอยู่เพื่อความเข้ากันได้ข้ามเอนด์พอยต์
Name
model_urls
Type
object
Description
URL ที่ดาวน์โหลดได้สำหรับโมเดล 3D ที่สร้างขึ้น การสร้างฟิกเกอร์จะส่งออก GLB ที่มีเท็กซ์เจอร์ พร้อมคู่ OBJ + MTL สำหรับไปป์ไลน์ที่ต้องการ Wavefront OBJ รูปแบบของฟิลด์ตรงกับอ็อบเจ็กต์ รูปภาพเป็น 3D model_urls เพื่อให้การเพิ่มรูปแบบในอนาคตสามารถเพิ่มเข้ามาได้โดยไม่เกิดการเปลี่ยนแปลงที่ทำให้เข้ากันไม่ได้
- Name
  glb
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังไฟล์ GLB ที่มีเท็กซ์เจอร์
- Name
  obj
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังไฟล์ Wavefront OBJ (จีออเมทรี + UV)
- Name
  mtl
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังไฟล์แมททีเรียล MTL ที่ใช้คู่กับ OBJ จับคู่กับ obj และรายการจาก texture_urls[0].base_color
Name
thumbnail_url
Type
string
Description
URL ที่ดาวน์โหลดได้ไปยังภาพย่อของไฟล์โมเดล
Name
texture_urls
Type
array
Description
อาร์เรย์ของอ็อบเจ็กต์ URL ของเท็กซ์เจอร์ที่สร้างโดยงานนี้ ปัจจุบันมีอ็อบเจ็กต์เดียวพร้อมแผนที่สีพื้นฐาน
- Name
  base_color
  Type
  string
  Description
  URL ที่ดาวน์โหลดได้ไปยังรูปภาพแผนที่สีพื้นฐาน

Example Figure Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}