Creative Lab — API Magnet Peti Sejuk

Tukar foto anda menjadi magnet peti sejuk tersuai — pelepasan kedalaman berwarna berbentuk segi empat tepat dengan belakang magnet rata, bersaiz untuk peti sejuk — dalam dua peringkat: prototip menjana imej konsep berwarna daripada foto input anda, kemudian bina menukar imej konsep itu menjadi model 3D relief. Kedua-dua peringkat dihubungkan melalui input_task_id.

  • POST /openapi/creative-lab/fridge-magnet/v1/prototype
  • POST /openapi/creative-lab/fridge-magnet/v1/build
POST/openapi/creative-lab/fridge-magnet/v1/prototype

Cipta Tugas Prototip Magnet Peti Sejuk

Hasilkan satu imej konsep berwarna dari foto sumber. ID tugas yang dikembalikan adalah apa yang anda serahkan sebagai input_task_id kepada endpoint binaan. Rujuk kepada Objek Tugas Prototip Magnet Peti Sejuk untuk bentuk respons.

Parameter

  • Name
    image_url
    Type
    string
    Diperlukan
    Description

    Foto sumber untuk Meshy mewarnakan menjadi imej konsep sedia magnet peti sejuk. Kami kini menyokong format .jpg, .jpeg, .png, dan .webp.

    Terdapat dua cara untuk menyediakan imej:

    • URL boleh diakses secara umum: URL yang boleh diakses dari internet awam.
    • Data URI: URI data yang dikodkan base64 bagi imej. Contoh Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
  • Name
    name
    Type
    string
    Description

    Nama tugas pilihan untuk tujuan paparan. Maksimum 100 aksara.

  • Name
    remove_background
    Type
    boolean
    lalai false
    Description

    Apabila ditetapkan kepada true, imej prototip dikembalikan sebagai PNG RGBA telus dengan latar belakang dibuang, jadi anda boleh menggabungkan subjek ke mana-mana latar belakang.

    Ini hanya mengawal imej yang dikembalikan oleh endpoint ini. Ia berasingan daripada pilihan binaan dengan nama yang sama (lalai true), yang mengawal penyingkiran latar belakang sebelum pelepasan.

Pulangan

Properti result dalam respons mengandungi id tugas prototip magnet peti sejuk yang baru dicipta. Poll endpoint Dapatkan Tugas atau langgan aliran sehingga tugas mencapai SUCCEEDED, kemudian serahkan ID itu kepada endpoint binaan sebagai input_task_id.

Mod Kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat diterima. Punca biasa:

    • Parameter hilang: image_url diperlukan.
    • Format imej tidak sah: image_url yang disediakan bukan format yang disokong (.jpg, .jpeg, .png, .webp).
    • Dimensi imej di luar julat: Imej terlalu kecil, melebihi saiz fail maksimum, atau melebihi jumlah piksel maksimum.
    • URL tidak dapat dicapai: image_url tidak dapat dimuat turun (404 atau timeout).
    • Data URI tidak sah: Rentetan base64 rosak.
    • Kandungan ditandakan: Imej input ditandakan oleh moderation NSFW atau harta intelek.
  • Name
    401 - Unauthorized
    Description

    Pengesahan gagal. Sila semak kunci API anda.

  • Name
    402 - Payment Required
    Description

    Kredit tidak mencukupi untuk melaksanakan tugas ini.

  • Name
    429 - Too Many Requests
    Description

    Anda telah melebihi had kadar anda.

Permintaan

POST
/openapi/creative-lab/fridge-magnet/v1/prototype
# Stage 1: generate a colorized fridge magnet concept image
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/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>"
  }'

Respons

{
  "result": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9"
}
Contoh prototip
Mulakan dengan foto sumber, kemudian hasilkan imej prototip yang digunakan oleh peringkat binaan magnet peti sejuk.
Foto landskap sumber yang digunakan sebagai input Magnet Peti Sejuk Creative Lab
Input prototip
Output prototip Magnet Peti Sejuk Creative Lab yang dihasilkan dari foto sumber
Output prototip
POST/openapi/creative-lab/fridge-magnet/v1/build

Cipta Tugas Pembinaan Magnet Peti Sejuk

Hasilkan magnet peti sejuk 3D yang boleh dicetak dari tugas prototaip yang berjaya. Pembinaan menjalankan saluran paip relief peta kedalaman pada imej konsep berwarna prototaip dan menghantar satu artifak jejaring dalam format yang anda minta. Rujuk kepada Objek Tugas Pembinaan Magnet Peti Sejuk untuk bentuk respons.

Parameter

  • Name
    input_task_id
    Type
    string
    Diperlukan
    Description

    ID tugas bagi tugas prototaip yang dicipta melalui endpoint OpenAPI yang sama. Prototaip mesti telah dicipta dengan kunci API yang sama, mesti telah mencapai SUCCEEDED, dan mesti telah menghasilkan tepat satu imej calon.

    Tugas prototaip yang dicipta melalui aplikasi web tidak diterima — endpoint pembinaan hanya menerima tugas prototaip yang dihasilkan oleh POST /openapi/creative-lab/fridge-magnet/v1/prototype dan menolak mana-mana sumber lain dengan 404.

  • Name
    name
    Type
    string
    Description

    Nama tugas pilihan untuk tujuan paparan. Maksimum 100 aksara.

options

Parameter penalaan pilihan untuk geometri relief. Setiap medan mempunyai nilai lalai yang munasabah — hantar hanya yang anda ingin ubah.

  • Name
    badge_shape
    Type
    string
    lalai rounded-rect
    Description

    Siluet garis besar magnet peti sejuk. Nilai yang tersedia:

    • circle
    • rounded-rect (lalai)
    • hexagon
    • shield
    • star
  • Name
    size_mm
    Type
    number
    lalai 60
    Description

    Panjang tepi segi empat sama magnet peti sejuk, dalam milimeter. Julat: (0, 400].

  • Name
    relief_height_mm
    Type
    number
    lalai 3.3
    Description

    Ketinggian relief maksimum di atas asas, dalam milimeter. Julat: [0, 20].

  • Name
    relief_offset_mm
    Type
    number
    lalai 0
    Description

    Ofset menegak yang digunakan pada relief sebelum penyemperitan, dalam milimeter. Julat: [0, 20].

  • Name
    base_thickness_mm
    Type
    number
    lalai 2.0
    Description

    Ketebalan plat asas rata di belakang relief, dalam milimeter. Lalai magnet peti sejuk adalah asas 2 mm yang lebih tebal — memberikan magnet cukup badan untuk mencengkam peti sejuk tanpa relief terasa rapuh. Julat: [0, 20].

  • Name
    has_closed_back
    Type
    boolean
    lalai true
    Description

    Sama ada belakang magnet peti sejuk ditutup sebagai permukaan tertutup (bahagian yang anda lekatkan magnet). Tetapkan kepada false untuk cangkerang terbuka.

  • Name
    relief_curve
    Type
    string
    lalai linear
    Description

    Lengkung pemindahan memetakan nilai peta kedalaman kepada ketinggian relief. Nilai yang tersedia:

    • linear (lalai)
    • gamma
    • s-curve
  • Name
    curve_param
    Type
    number
    lalai 1.0
    Description

    Parameter bentuk untuk lengkung pemindahan (hanya bermakna apabila relief_curve adalah gamma). Julat: (0, 10].

  • Name
    invert_depth
    Type
    boolean
    lalai false
    Description

    Balikkan tafsiran peta kedalaman supaya kawasan yang lebih gelap menjadi relief yang lebih tinggi.

  • Name
    smoothing
    Type
    number
    lalai 0.24
    Description

    Kekuatan pelicinan yang digunakan pada peta kedalaman sebelum pengekstrakan relief. Julat: [0, 10].

  • Name
    relief_scale
    Type
    number
    lalai 1.0
    Description

    Pengganda skala menegak yang digunakan di atas relief_height_mm. Julat: (0, 10].

  • Name
    depth_threshold
    Type
    number
    lalai 0.1
    Description

    Ambang laluan rendah untuk nilai peta kedalaman; apa-apa di bawah ini dikapit kepada sifar. Julat: [0, 1].

  • Name
    remove_background
    Type
    boolean
    lalai true
    Description

    Secara automatik mengeluarkan latar belakang imej konsep prototaip sebelum membuat relief.

    Berasingan daripada parameter prototaip dengan nama yang sama (lalai false), yang mengawal sama ada imej prototaip itu sendiri dikembalikan dengan ketelusan.

  • Name
    export_resolution
    Type
    integer
    lalai 512
    Description

    Resolusi jejaring yang digunakan untuk eksport. Julat: [64, 2048].

output

Pemilih format wayar pilihan. Lalai kepada glb.

  • Name
    format
    Type
    string
    lalai glb
    Description

    Bundel artifak yang dikembalikan oleh pembinaan. Nilai yang tersedia:

    • glb (lalai) — mengembalikan satu model.glb di bawah model_urls.glb.
    • obj — memampatkan model.obj + model.mtl + texture.png dan mengembalikan bundel di bawah model_urls.obj.
    • zip — memampatkan setiap artifak yang dihasilkan oleh penjana dan mengembalikan bundel di bawah model_urls.bundle_zip.

Mengembalikan

Harta result dalam respons mengandungi id tugas bagi tugas pembinaan magnet peti sejuk yang baru dicipta. Pantau endpoint Dapatkan Tugas atau langgan aliran sehingga tugas mencapai SUCCEEDED, kemudian muat turun artifak dari entri tunggal dalam model_urls.

Mod Kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat diterima. Punca biasa:

    • Parameter hilang: input_task_id diperlukan.
    • UUID tidak sah: input_task_id bukan UUID yang sah.
    • Induk tidak berjaya: Tugas prototaip yang dirujuk belum mencapai SUCCEEDED.
    • Tiada calon: Tugas prototaip berjaya tetapi tidak menghasilkan imej calon.
    • Pilihan di luar julat: Salah satu medan options berada di luar julat atau set enum yang dibenarkan.
  • Name
    401 - Unauthorized
    Description

    Pengesahan gagal. Sila semak kunci API anda.

  • Name
    402 - Payment Required
    Description

    Kredit tidak mencukupi untuk melaksanakan tugas ini.

  • Name
    404 - Not Found
    Description

    Tugas prototaip yang dirujuk tidak wujud, milik pengguna lain, atau dicipta melalui aplikasi web (hanya tugas prototaip mod API yang berantai ke dalam pembinaan).

  • Name
    429 - Too Many Requests
    Description

    Anda telah melebihi had kadar anda.

Permintaan

POST
/openapi/creative-lab/fridge-magnet/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "options": {
      "badge_shape": "rounded-rect",
      "size_mm": 60,
      "relief_height_mm": 3.3
    },
    "output": {
      "format": "glb"
    }
  }'

Respons

{
  "result": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0"
}
Contoh binaan
Tugas binaan menukar imej prototaip terpilih menjadi model magnet peti sejuk yang boleh dicetak 3D.
Pratonton model binaan Magnet Peti Sejuk Creative Lab
Pratonton model binaan
GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Dapatkan Tugas Magnet Peti Sejuk

Dapatkan tugas prototaip atau binaan dengan memberikan id tugas yang sah. Laluan URL mesti sepadan dengan peringkat tugas — tugas binaan yang diambil melalui /prototype/:id akan mengembalikan 404, dan sebaliknya.

Rujuk kepada Objek Tugas Prototaip Magnet Peti Sejuk dan Objek Tugas Binaan Magnet Peti Sejuk untuk bentuk respons.

Parameter

  • Name
    id
    Type
    path
    Description

    Pengenal unik untuk tugas magnet peti sejuk yang ingin didapatkan.

Pulangan

Respons mengandungi objek tugas magnet peti sejuk. Bentuknya bergantung pada peringkat yang diminta.

Permintaan

GET
/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Respons Prototaip

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Respons Binaan

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}
DELETE/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Padam Tugas Magnet Peti Sejuk

Batalkan tugas magnet peti sejuk. Jika tugas masih PENDING, kredit yang digunakan semasa penciptaan akan dikembalikan. Tugas yang sudah IN_PROGRESS dibatalkan tanpa pengembalian (pekerja mungkin sudah menggunakan sumber). Tugas yang telah mencapai keadaan terminal (SUCCEEDED, FAILED, CANCELED) tidak boleh dibatalkan.

Laluan URL mesti sepadan dengan peringkat tugas — DELETE pada /prototype/:buildId mengembalikan 404.

Parameter Laluan

  • Name
    id
    Type
    path
    Description

    Pengenal pasti unik untuk tugas magnet peti sejuk yang hendak dibatalkan.

Pemulangan

Mengembalikan 204 No Content pada kejayaan dengan badan kosong.

Mod Kegagalan

  • Name
    400 - Bad Request
    Description

    Tugas sudah berada dalam keadaan terminal dan tidak boleh dibatalkan.

  • Name
    404 - Not Found
    Description

    Tugas tidak wujud, milik pengguna lain, atau peringkatnya tidak sepadan dengan laluan URL.

Permintaan

DELETE
/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Respons

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

Strim Tugas Magnet Peti Sejuk

Strim kemas kini masa nyata untuk tugas magnet peti sejuk melalui Server-Sent Events (SSE). Laluan URL mesti sepadan dengan peringkat tugas — membuka strim di /prototype/:buildId/stream akan mengeluarkan satu event: error payload dengan status_code: 404 dan menutup strim.

Parameter

  • Name
    id
    Type
    path
    Description

    Pengenal pasti unik untuk tugas magnet peti sejuk untuk strim.

Mengembalikan

Mengembalikan strim objek tugas Magnet Peti Sejuk Prototaip atau Magnet Peti Sejuk Bina sebagai Server-Sent Events. Untuk tugas PENDING atau IN_PROGRESS, strim respons hanya akan menyertakan medan progress dan status yang diperlukan.

Permintaan

GET
/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream
curl -N https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Strim Respons

// 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": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}
GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)

Senarai Tugasan Magnet Peti Sejuk

Dapatkan senarai berpenomboran halaman bagi tugasan magnet peti sejuk anda untuk satu peringkat. Laluan URL memilih peringkat — /prototype mengembalikan tugasan prototaip; /build mengembalikan tugasan binaan. Tugasan dari peringkat lain tidak termasuk dalam mana-mana respons.

Parameter Laluan

  • Name
    stage
    Type
    path
    Diperlukan
    Description

    Sama ada prototype atau build. Koleksi mengembalikan hanya tugasan yang peringkatnya sepadan dengan URL — mendapatkan /prototype tidak akan mengembalikan tugasan binaan dan sebaliknya.

Parameter Pertanyaan

  • Name
    page_num
    Type
    integer
    lalai 1
    Description

    Nombor halaman untuk penomboran halaman.

  • Name
    page_size
    Type
    integer
    lalai 10
    Description

    Had saiz halaman. Maksimum yang dibenarkan ialah 50 item.

  • Name
    sort_by
    Type
    string
    lalai -created_at
    Description

    Medan untuk disusun. Nilai yang tersedia:

    • +created_at: Susun mengikut masa penciptaan dalam susunan menaik.
    • -created_at: Susun mengikut masa penciptaan dalam susunan menurun.

Mengembalikan

Mengembalikan senarai berpenomboran halaman bagi objek tugasan per-peringkat — sama ada objek tugasan prototaip magnet peti sejuk apabila menyenaraikan /prototype atau objek tugasan binaan magnet peti sejuk apabila menyenaraikan /build.

Permintaan

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

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

Respons (Senarai Tugasan Prototaip)

[
  {
    "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "type": "creative-lab-fridge-magnet-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729543210000,
    "started_at": 1729543215000,
    "finished_at": 1729543242000,
    "expires_at": 1729802442000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Objek Tugas Prototip Magnet Peti Sejuk

Objek Tugas Prototip Magnet Peti Sejuk adalah unit kerja yang Meshy jejak untuk menghasilkan imej konsep berwarna daripada foto sumber. Hasil daripada tahap ini dihubungkan ke tahap binaan melalui input_task_id.

Sifat

  • Name
    id
    Type
    string
    Description

    Pengenal pasti unik untuk tugas ini. Walaupun kami menggunakan UUID yang boleh disusun k untuk id tugas sebagai butiran pelaksanaan, anda tidak seharusnya membuat sebarang andaian tentang format id tersebut.

  • Name
    type
    Type
    string
    Description

    Jenis tugas. Nilainya adalah creative-lab-fridge-magnet-prototype.

  • Name
    name
    Type
    string
    Description

    Nama tugas yang diberikan semasa tugas dicipta. Rentetan kosong jika tiada nama diberikan.

  • Name
    status
    Type
    string
    Description

    Status tugas. Nilai yang mungkin adalah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Kemajuan tugas. Jika tugas belum dimulakan, sifat ini akan menjadi 0. Setelah tugas berjaya, ini akan menjadi 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Cap masa apabila tugas dicipta, dalam milisaat.

    Cap masa mewakili bilangan milisaat yang berlalu sejak 1 Januari 1970 UTC, mengikut piawaian RFC 3339. Sebagai contoh, Jumaat, 1 September 2023 12:00:00 PM GMT diwakili sebagai 1693569600000. Ini terpakai kepada semua cap masa dalam Meshy API.

  • Name
    started_at
    Type
    timestamp
    Description

    Cap masa apabila tugas dimulakan, dalam milisaat. Jika tugas belum dimulakan, sifat ini akan menjadi 0.

  • Name
    finished_at
    Type
    timestamp
    Description

    Cap masa apabila tugas selesai, dalam milisaat. Jika tugas belum selesai, sifat ini akan menjadi 0.

  • Name
    expires_at
    Type
    timestamp
    Description

    Cap masa apabila hasil tugas tamat tempoh, dalam milisaat.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Bilangan tugas terdahulu.

    Nilai medan ini bermakna hanya jika status tugas adalah PENDING.

  • Name
    task_error
    Type
    object
    Description

    Butiran ralat untuk tugas yang gagal. Lihat Ralat untuk rujukan penuh objek task_error.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang digunakan oleh tugas ini. Hadir apabila status tugas adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk tugas FAILED (kredit dikembalikan pada kegagalan).

  • Name
    image_urls
    Type
    array of strings
    Description

    URL yang boleh dimuat turun untuk calon imej konsep yang dihasilkan oleh tugas prototip ini. Pada masa ini API sentiasa mengembalikan tepat satu calon; medan ini adalah tatasusunan supaya semakan masa depan dapat menampilkan pelbagai calon tanpa perubahan yang memecahkan.

Contoh Objek Tugas Prototip Magnet Peti Sejuk

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Objek Tugas Bina Magnet Peti Sejuk

Objek Tugas Bina Magnet Peti Sejuk adalah unit kerja yang Meshy jejak untuk menjana jejaring magnet peti sejuk 3D akhir daripada tugas prototaip yang berjaya. Pembinaan menjalankan saluran pelepasan peta-kedalaman pada imej konsep prototaip dan menerbitkan satu artifak jejaring dalam format yang diminta oleh pemanggil.

Sifat

  • Name
    id
    Type
    string
    Description

    Pengenal pasti unik untuk tugas ini.

  • Name
    type
    Type
    string
    Description

    Jenis tugas. Nilainya adalah creative-lab-fridge-magnet-build.

  • Name
    name
    Type
    string
    Description

    Nama tugas yang dibekalkan semasa tugas dicipta. Rentetan kosong jika tiada nama diberikan.

  • Name
    status
    Type
    string
    Description

    Status tugas. Nilai yang mungkin adalah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Kemajuan tugas. Jika tugas belum dimulakan, sifat ini akan menjadi 0. Setelah tugas berjaya, ini akan menjadi 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Cap masa apabila tugas dicipta, dalam milisaat.

  • Name
    started_at
    Type
    timestamp
    Description

    Cap masa apabila tugas dimulakan, dalam milisaat.

  • Name
    finished_at
    Type
    timestamp
    Description

    Cap masa apabila tugas selesai, dalam milisaat.

  • Name
    expires_at
    Type
    timestamp
    Description

    Cap masa apabila hasil tugas tamat tempoh, dalam milisaat.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Bilangan tugas terdahulu. Bermakna hanya apabila status adalah PENDING.

  • Name
    task_error
    Type
    object
    Description

    Butiran ralat untuk tugas yang gagal. Lihat Ralat untuk rujukan penuh objek task_error.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang digunakan oleh tugas ini. Mengembalikan 0 untuk tugas FAILED (kredit dikembalikan jika gagal).

  • Name
    model_urls
    Type
    object
    Description

    URL yang boleh dimuat turun untuk artifak yang dijana, dikunci dengan nama artifak. Sentiasa mengandungi tepat satu entri — format yang diminta melalui permintaan binaan output.format. Kunci sepadan dengan format yang diminta:

    • Name
      glb
      Type
      string
      Description

      URL yang boleh dimuat turun untuk fail GLB. Hadir apabila output.format adalah glb (lalai).

    • Name
      obj
      Type
      string
      Description

      URL yang boleh dimuat turun untuk pakej zip yang mengandungi model.obj, model.mtl, dan texture.png. Hadir apabila output.format adalah obj.

    • Name
      bundle_zip
      Type
      string
      Description

      URL yang boleh dimuat turun untuk pakej zip setiap artifak yang dihasilkan oleh penjana. Hadir apabila output.format adalah zip.

Contoh Objek Tugas Bina Magnet Peti Sejuk

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}