Creative Lab — ฟิกเกอร์รูปแบบแบบอิฐ API

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

  • POST /openapi/creative-lab/brick-figure/v1/prototype
  • POST /openapi/creative-lab/brick-figure/v1/build
POST/openapi/creative-lab/brick-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 ไม่ถูกต้อง
    • เนื้อหาถูกตั้งข้อสังเกต: ภาพที่ป้อนได้ถูกตั้งข้อสังเกตด้วยการ moderation ของ NSFW หรือทรัพย์สินทางปัญญา
  • Name
    401 - Unauthorized
    Description

    การยืนยันตัวตนล้มเหลว กรุณาตรวจสอบ API คีย์ของคุณ

  • Name
    402 - Payment Required
    Description

    เครดิตไม่เพียงพอที่จะดำเนินการงานนี้

  • Name
    403 - Forbidden
    Description

    รูปภาพอินพุตถูกตั้งค่าสถานะเนื่องจากละเมิดทรัพย์สินทางปัญญา

  • Name
    429 - Too Many Requests
    Description

    คุณได้เกินการจำกัดอัตราของคุณแล้ว

Request

POST
/openapi/creative-lab/brick-figure/v1/prototype
# ส่วนที่ 1: สร้างภาพแนวคิดสไตล์อิฐ
curl https://api.meshy.ai/openapi/creative-lab/brick-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"
}
POST/openapi/creative-lab/brick-figure/v1/build

สร้างงานประกอบฟิกเกอร์อิฐ

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

พารามิเตอร์

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

    รหัสงานของงานต้นแบบที่สร้างขึ้นผ่านเอนด์พอยต์ OpenAPI เดียวกันนี้ งานต้นแบบต้องถูกสร้างขึ้นด้วย API คีย์เดียวกัน ต้องถึง SUCCEEDED และต้องสร้างรูปภาพต้นแบบเพียงภาพเดียวเท่านั้น

    งานต้นแบบที่สร้างผ่านเวบแอป ไม่ได้รับการยอมรับ — เอนด์พอยต์การประกอบรับเฉพาะงานต้นแบบที่สร้างจาก POST /openapi/creative-lab/brick-figure/v1/prototype และปฏิเสธแหล่งที่มาที่อื่น ๆ ด้วย 404.

  • Name
    name
    Type
    string
    Description

    ชื่อสำหรับแสดงผลที่ไม่จำเป็น มีความยาวสูงสุด 100 อักขระ

ผลลัพธ์ที่คืนกลับ

คุณสมบัติ result ของการตอบกลับจะมีรหัสงาน id ของงานประกอบฟิกเกอร์อิฐที่สร้างใหม่ ค้นหา รับงาน เอนด์พอยต์หรือสมัคร สตรีม จนกว่างานจะถึง SUCCEEDED แล้วดาวน์โหลด GLB ที่ใช้เป็นเท็กซ์เจอร์จาก model_urls.glb (หรือคู่ OBJ + MTL จาก model_urls.obj และ model_urls.mtl ถ้าสายการประมวลผลของคุณชอบ OBJ)

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

  • Name
    400 - Bad Request
    Description

    คำขอไม่ได้รับการยอมรับ สาเหตุที่พบบ่อย:

    • ขาดพารามิเตอร์: input_task_id เป็นพารามิเตอร์ที่จำเป็น
    • UUID ไม่ถูกต้อง: input_task_id ไม่ใช่ UUID ที่ถูกต้อง
    • ต้นแบบไม่สำเร็จ: งานต้นแบบที่อ้างอิงยังไม่ถึง SUCCEEDED
    • ไม่มีต้นแบบ: งานต้นแบบสำเร็จแต่ไม่สร้างรูปภาพต้นแบบ
  • Name
    401 - Unauthorized
    Description

    การยืนยันตัวตนล้มเหลว กรุณาตรวจสอบ API คีย์ของคุณ

  • Name
    402 - Payment Required
    Description

    เครดิตไม่เพียงพอในการทำงานนี้

  • Name
    404 - Not Found
    Description

    งานต้นแบบที่อ้างอิงไม่มีอยู่, เป็นของผู้ใช้คนอื่น, หรือถูกสร้างขึ้นผ่านเวบแอป (เฉพาะงานต้นแบบที่มีในโหมด API เท่านั้นที่สามารถเชื่อมเป็นงานประกอบได้)

  • Name
    429 - Too Many Requests
    Description

    คุณเกินการจำกัดอัตราคำขอ

Request

POST
/openapi/creative-lab/brick-figure/v1/build
# ขั้นตอนที่ 2: เชื่อมงานประกอบจากงานต้นแบบที่สำเร็จ
curl https://api.meshy.ai/openapi/creative-lab/brick-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"
}
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

รับงานฟิกเกอร์อิฐ

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

ดูที่ อ็อบเจ็กต์งานต้นแบบฟิกเกอร์อิฐ และ อ็อบเจ็กต์งานสร้างฟิกเกอร์อิฐ สำหรับรูปแบบการตอบกลับ

พารามิเตอร์

  • Name
    id
    Type
    path
    Description

    ตัวระบุเฉพาะสำหรับงานฟิกเกอร์อิฐที่ต้องการรับ

การคืนค่า

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

Request

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

# Build
curl https://api.meshy.ai/openapi/creative-lab/brick-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-brick-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-brick-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": 30,
  "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/brick-figure/v1/(prototype|build)/:id

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

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

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

พารามิเตอร์ใน Path

  • Name
    id
    Type
    path
    Description

    ตัวระบุเฉพาะสำหรับงานฟิกเกอร์ที่ต้องการยกเลิก

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

คืนค่า 204 No Content ในกรณีที่สำเร็จโดยไม่มีข้อมูลในตัวเนื้อหา

โหมดการล้มเหลว

  • Name
    400 - Bad Request
    Description

    งานอยู่ในสถานะสิ้นสุดแล้วและไม่สามารถยกเลิกได้

  • Name
    404 - Not Found
    Description

    งานไม่พบหรือเป็นของผู้ใช้อื่น หรือขั้นของงานไม่ตรงกับ URL path

คำขอ

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

การตอบรับ

// คืนค่า 204 No Content เมื่อสำเร็จ (ไม่มีเนื้อหาในตัว)
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id/stream

สตรีมข้อมูลสำหรับภารกิจฟิกเกอร์

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

พารามิเตอร์

  • Name
    id
    Type
    path
    Description

    รหัสเฉพาะที่ระบุภารกิจฟิกเกอร์เพื่อสตรีม

การส่งคืน

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

Request

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

Response Stream

// ตัวอย่างอีเวนต์ข้อผิดพลาด (ขั้นตอนไม่ถูกต้องหรือไม่พบภารกิจ)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// ตัวอย่างอีเวนต์ข้อความแสดงความคืบหน้าของภารกิจ
// สำหรับภารกิจที่เป็น PENDING หรือ IN_PROGRESS สตรีมการตอบกลับจะไม่รวมทุกฟิลด์
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-brick-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 30,
  "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/brick-figure/v1/(prototype|build)

รายการงานฟิกเกอร์อิฐ

ดึงรายการงานฟิกเกอร์อิฐที่แบ่งหน้าในระยะหนึ่ง URL ที่เส้นทางจะเลือกระยะ — /prototype จะคืนงานต้นแบบ; /build จะคืนงานก่อสร้าง งานจากระยะอื่นจะไม่รวมในคำตอบทั้งสอง

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

  • Name
    stage
    Type
    path
    จำเป็น
    Description

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

พารามิเตอร์การค้นหา

  • Name
    page_num
    Type
    integer
    ค่าเริ่มต้น 1
    Description

    หมายเลขหน้าสำหรับการแบ่งหน้า

  • Name
    page_size
    Type
    integer
    ค่าเริ่มต้น 10
    Description

    ขีดจำกัดขนาดหน้า ขีดจำกัดสูงสุดคือ 100 รายการ

  • Name
    sort_by
    Type
    string
    ค่าเริ่มต้น -created_at
    Description

    ฟิลด์ที่จะเรียงลำดับ ค่าที่ใช้ได้:

    • +created_at: เรียงลำดับตามเวลาในการสร้างในลำดับการเพิ่มขึ้น
    • -created_at: เรียงลำดับตามเวลาในการสร้างในลำดับการลดลง

คืนค่า

คืนรายการงานต่อระยะที่แบ่งหน้า — ไม่ว่า วัตถุงานฟิกเกอร์อิฐต้นแบบ เมื่อรายการ /prototype หรือ วัตถุงานฟิกเกอร์อิฐสร้าง เมื่อ รายการ /build.

Request

GET
/openapi/creative-lab/brick-figure/v1/prototype
# รายการงานต้นแบบ
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# รายการงานก่อสร้าง
curl https://api.meshy.ai/openapi/creative-lab/brick-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-brick-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 สำหรับ ids งานในรายละเอียดการใช้งาน แต่คุณ ไม่ควร สันนิษฐานเกี่ยวกับรูปแบบของ id

  • Name
    type
    Type
    string
    Description

    ประเภทของงาน ค่าเป็น creative-lab-brick-figure-prototype

  • Name
    name
    Type
    string
    Description

    ชื่องานที่ระบุเมื่อสร้างงาน ว่างหากไม่มีการให้ชื่อ

  • Name
    status
    Type
    string
    Description

    สถานะของงาน ค่าที่เป็นไปได้คือหนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED

  • Name
    progress
    Type
    integer
    Description

    ความก้าวหน้าของงาน หากงานยังไม่ได้เริ่มต้น คุณสมบัตินี้จะเป็น 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

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

  • Name
    finished_at
    Type
    timestamp
    Description

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

  • 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

    URLs สำหรับการดาวน์โหลดรูปภาพแนวคิดที่สร้างโดยงานต้นแบบนี้ ปัจจุบัน API คืนค่าผู้สมัครเพียงคนเดียว แต่ฟิลด์นี้เป็นอาเรย์เพื่อให้การปรับปรุงในอนาคตสามารถเผยผู้สมัครหลายคนโดยไม่เกิดปัญหา

Example Brick Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-brick-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 ที่มีพื้นผิวจากงานต้นแบบที่ SUCCEEDED โดยจะดำเนินการตามกระบวนการเดียวกับรูปภาพเป็น 3D ที่ใช้โดย รูปภาพเป็น 3D ดังนั้นฟิลด์ผลลัพธ์จะสะท้อนวัตถุงานของเอนด์พอยต์นั้น วัตถุงาน

คุณสมบัติ

  • Name
    id
    Type
    string
    Description

    ตัวระบุเฉพาะสำหรับงาน.

  • Name
    type
    Type
    string
    Description

    ประเภทของงาน. ค่านี้คือ creative-lab-brick-figure-build.

  • Name
    name
    Type
    string
    Description

    ชื่องานที่ระบุเมื่อสร้างงาน. เป็นค่าว่างถ้าไม่มีการระบุชื่อ.

  • Name
    status
    Type
    string
    Description

    สถานะของงาน. ค่าที่เป็นไปได้คือหนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    ความคืบหน้าของงาน. ถ้างานยังไม่เริ่ม ค่านี้จะเป็น 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

    รายละเอียดข้อผิดพลาดสำหรับงานที่ล้มเหลว. ดู Errors สำหรับข้อมูลการอ้างอิง task_error เต็มรูปแบบ.

  • Name
    consumed_credits
    Type
    integer
    Description

    จำนวนเครดิตที่ใช้โดยงานนี้. คืนค่าเป็น 0 สำหรับงาน FAILED (เครดิตจะถูกคืนเมื่อเกิดข้อผิดพลาด).

  • Name
    prompt
    Type
    string
    Description

    เป็นค่าว่างเสมอสำหรับการสร้างฟิกเกอร์ตัวต่อ. มีเพื่อความเข้ากันได้ของข้ามเอนด์พอยต์กับรูปแบบ V2ImageTo3DTaskResponse ที่ใช้ร่วมกันโดย Image to 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

    URLs สำหรับดาวน์โหลดโมเดล 3D ที่สร้างขึ้น. การสร้างฟิกเกอร์ตัวต่อจะปล่อยออกเป็น GLB ที่มีเท็กซ์เจอร์และคู่ OBJ + MTL สำหรับการใช้งานในท่อที่ต้องการ Wavefront OBJ. รูปร่างสนามตรงกับวัตถุ Image to 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 สำหรับดาวน์โหลดไฟล์แมททีเรียลคู่กับ OBJ MTL. ใช้คู่กับ 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 Brick Figure Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-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": 30,
  "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=***"
    }
  ]
}