Creative Lab — Vinyl Figure API

เปลี่ยนภาพถ่ายต้นฉบับให้เป็นฟิกเกอร์ 3D แบบหัวโตในสองขั้นตอน: ต้นแบบ สร้างภาพแนวคิดที่มีสไตล์จากภาพถ่ายต้นฉบับของคุณ จากนั้น สร้าง เปลี่ยนภาพแนวคิดนั้นให้เป็นโมเดล 3D ที่มี 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

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

สร้างภาพแนวคิดสไตล์ฟิกเกอร์ไวนิลจากภาพต้นฉบับ ภารกิจที่ส่งคืน 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 ตัวอักษร

  • Name
    remove_background
    Type
    boolean
    ค่าเริ่มต้น false
    Description

    เมื่อกำหนดเป็น true ภาพต้นแบบจะถูกส่งคืนเป็น PNG RGBA โปร่งใสพร้อมพื้นหลังที่ถูกลบออก เพื่อให้คุณสามารถประกอบวัตถุลงบนพื้นหลังใดก็ได้

การส่งคืน

คุณสมบัติ 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 key ของคุณ

  • Name
    402 - Payment Required
    Description

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

  • Name
    429 - Too Many Requests
    Description

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

Request

POST
/openapi/creative-lab/vinyl-figure/v1/prototype
# Stage 1: generate a vinyl-figure-style concept image
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"
}
ตัวอย่างต้นแบบ
เริ่มต้นด้วยภาพต้นฉบับ จากนั้นสร้างภาพต้นแบบที่ใช้ในขั้นตอนการสร้าง
ภาพต้นฉบับที่ใช้เป็นข้อมูลนำเข้า Creative Lab Vinyl Figure
ข้อมูลนำเข้าต้นแบบ
ภาพต้นแบบฟิกเกอร์ไวนิลหัวโตที่สร้างจากภาพต้นฉบับ
ผลลัพธ์ต้นแบบ
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
# Stage 2: chain build off a succeeded prototype task
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

// 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": "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

คุณสมบัติ

  • Name
    id
    Type
    string
    Description

    ตัวระบุเฉพาะสำหรับงานนี้ แม้ว่าเราจะใช้ UUID ที่สามารถเรียงลำดับได้สำหรับ id ของงานเป็นรายละเอียดการใช้งาน คุณไม่ควรทำการสันนิษฐานใดๆ เกี่ยวกับรูปแบบของ id

  • 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 ที่มีเท็กซ์เจอร์ จากงานต้นแบบที่สำเร็จแล้ว มันใช้กระบวนการแปลงรูปภาพเป็น 3D เดียวกันกับ รูปภาพเป็น 3D ดังนั้นฟิลด์ผลลัพธ์จะสะท้อนถึง วัตถุงาน ของเอนด์พอยต์นั้น

คุณสมบัติ

  • 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 สำหรับดาวน์โหลดไฟล์แมททีเรียล 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 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=***"
    }
  ]
}