Creative Lab — Vinyl Figure API

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

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

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

สร้างภาพคอนเซปต์สไตล์ฟิกเกอร์ไวนิลจากภาพต้นฉบับ หน่วยงานที่ได้รับย้อนกลับคืนจะเป็นสิ่งที่คุณส่งไปเป็น input_task_id ไปยังเอนด์พอยต์สร้างเพิ่มเติม ดูเพิ่มเติมที่ The Vinyl Figure Prototype Task Object สำหรับรูปแบบการตอบกลับ

พารามิเตอร์

  • 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

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

คำขอ

POST
/openapi/creative-lab/vinyl-figure/v1/prototype
# ขั้นตอนที่ 1: สร้างภาพคอนเซปต์สไตล์ฟิกเกอร์ไวนิล
curl https://api.meshy.ai/openapi/creative-lab/vinyl-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": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}
Prototype example
Start with a source portrait, then generate the prototype image used by the build stage.
Source photo used as the Creative Lab Vinyl Figure input
Prototype input
Big-head vinyl figure prototype image generated from the source photo
Prototype output
POST/openapi/creative-lab/vinyl-figure/v1/build

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

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

พารามิเตอร์

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

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

    งานต้นแบบที่สร้างผ่านเว็บแอป ไม่ ถูกยอมรับ — เอนด์พอยต์บิลด์รับเฉพาะงานต้นแบบที่ผลิตโดย POST /openapi/creative-lab/vinyl-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/vinyl-figure/v1/build
# ขั้นตอนที่ 2: โซ่บิลด์จากงานต้นแบบที่ประสบความสำเร็จ
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

เรียกดึงงานฟิกเกอร์ไวนิล

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

อ้างอิงถึง อ็อบเจ็กต์งานต้นแบบของฟิกเกอร์ไวนิล และ อ็อบเจ็กต์งานสร้างฟิกเกอร์ไวนิล สำหรับ รูปแบบการตอบกลับ

พารามิเตอร์

  • Name
    id
    Type
    path
    Description

    หมายเลขประจำตัวที่ไม่ซ้ำกันสำหรับงานฟิกเกอร์ไวนิลที่จะเรียกดึง

การคืนค่า

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

Request

GET
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "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/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

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

ยกเลิกงานฟิกเกอร์ไวนิล หากงานยังอยู่ในสถานะ PENDING เครดิตที่ใช้ตอนสร้างจะถูกคืน งานที่อยู่ในสถานะ IN_PROGRESS จะถูกยกเลิกโดยไม่มีการคืนเครดิต (อาจมีการใช้แหล่งข้อมูลไปแล้ว) งานที่อยู่ในสถานะทั้ง 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/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

สตรีมการทำงานของฟิกเกอร์ไวนิล

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

พารามิเตอร์

  • Name
    id
    Type
    path
    Description

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

ผลลัพธ์

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

Request

GET
/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream
curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/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": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
GET/openapi/creative-lab/vinyl-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

    ขีดจำกัดขนาดหน้า ขนาดสูงสุดที่อนุญาตคือ 50 รายการ

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

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

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

การคืนค่า

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

Request

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

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

Response (List Prototype Tasks)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

วัตถุของภาระกิจต้นแบบฟิกเกอร์ไวนิล

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

Properties

  • Name
    id
    Type
    string
    Description

    ตัวระบุที่ไม่ซ้ำกันสำหรับงานนี้ เราใช้ k-sortable UUID สำหรับไอดีของงานตามรายละเอียดการใช้งาน คุณไม่ควรทำการสันนิษฐานใดๆ เกี่ยวกับรูปแบบของไอดี

  • Name
    type
    Type
    string
    Description

    ประเภทของงาน ค่าคือ creative-lab-vinyl-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

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

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

Example Vinyl Figure Prototype Task Object

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

วัตถุงานสร้างฟิกเกอร์ไวนิล

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

Properties

  • Name
    id
    Type
    string
    Description

    ตัวระบุที่ไม่ซ้ำกันสำหรับงาน

  • Name
    type
    Type
    string
    Description

    ประเภทของงาน ค่าเป็น creative-lab-vinyl-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

    รายละเอียดข้อผิดพลาดสำหรับงานที่ล้มเหลว ดู ข้อผิดพลาด สำหรับการอ้างอิงวัตถุ 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 รูปร่างของฟิลด์ตรงกับวัตถุ 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 companion 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 Vinyl Figure Build Task Object

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "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/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}