API Figura Bata Creative Lab
Ubah foto menjadi minifigur boleh dikumpul 3D bergaya bata dalam dua peringkat. Tugasan prototaip menjana imej konsep daripada foto tersebut. Tugasan pembinaan pula mengubah imej tersebut menjadi model 3D bertekstur, dan mengambil ID tugasan prototaip sebagai input_task_id.
POST /openapi/creative-lab/brick-figure/v1/prototypePOST /openapi/creative-lab/brick-figure/v1/build
Cipta tugas prototaip Brick Figure
Menjana satu imej konsep bergaya bata daripada sebuah foto. Untuk membina model 3D, hantar ID tugas ini ke build endpoint sebagai input_task_id. Untuk medan-medan tugas ini, lihat The Brick Figure prototype task object.
Request
# Stage 1: generate a brick-style concept image
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"
}
Parameter
- Name
- image_url
- Type
- string
- Diperlukan
- Description
Foto yang akan ditukar menjadi minifigure bata, sebagai URL awam atau data URI (
data:image/jpeg;base64,<data imej anda yang dikodkan base64>).Imej mestilah fail JPG, JPEG, PNG, atau WebP dengan saiz maksimum 20 MB.
- Name
- name
- Type
- string
- Description
Nama untuk tugas, sehingga 100 aksara. Ia akan dikembalikan dalam medan
nametugas tersebut. Nama yang lebih panjang akan mengembalikan400.
- Name
- remove_background
- Type
- boolean
- lalai false
- Description
Sama ada untuk membuang latar belakang daripada imej prototaip.
truemengembalikan PNG RGBA lutsinar, supaya anda boleh meletakkan subjek pada sebarang latar belakang. Pembinaan juga bermula daripada imej tanpa latar belakangnya. Jika Meshy tidak dapat membuang latar belakang, ia akan mengembalikan imej berserta latar belakangnya, dan tugas tetap berjaya.
Nilai yang dikembalikan
Medan result menyimpan ID tugas prototaip yang baharu. Dapatkan tugas atau strim tugas tersebut sehingga status menjadi SUCCEEDED. Kemudian hantar ID tersebut ke build endpoint sebagai input_task_id.
Mod kegagalan
- Name
400 - Bad Request- Description
Permintaan tidak dapat dijalankan. Contohnya:
image_urltiada.- Imej bukan fail JPG, JPEG, PNG, atau WebP.
- Imej terlalu kecil, melebihi 20 MB, atau melebihi bilangan piksel maksimum.
- Meshy tidak dapat memuat turun imej, contohnya kerana URL mengembalikan
404atau tamat masa. - Data URI bukan base64 yang sah.
- Imej ditandai sebagai NSFW.
Mesej ralat menyatakan masalah yang ditemui. Betulkan permintaan, kemudian hantar semula.
- Name
401 - Unauthorized- Description
Kunci API tiada atau tidak sah. Semak header
Authorization.
- Name
402 - Payment Required- Description
Salah satu daripada perkara berikut berlaku:
- Akaun tidak mempunyai kredit yang mencukupi.
- Kunci API, ruang kerja, atau ahli telah mencapai had kredit.
- Akaun berada pada pelan percuma.
Semak kredit dan pelan anda, kemudian cuba semula.
- Name
403 - Forbidden- Description
Pasukan anda telah menghidupkan IP Filtering, dan Meshy menandai imej tersebut kerana harta intelek pihak ketiga. Hantar imej yang anda mempunyai hak untuk guna.
- Name
429 - Too Many Requests- Description
Salah satu had berikut telah dicapai:
- Anda menghantar lebih banyak permintaan daripada yang dibenarkan oleh had kadar anda. Tunggu beberapa saat, kemudian cuba semula. Lihat Rate limits.
- Terlalu banyak tugas anda sedang beratur atau sedang berjalan. Tunggu sehingga sebahagiannya selesai, kemudian cuba semula.
- Pada pelan tanpa had tanpa baki kredit, anda telah mencapai bilangan tugas yang boleh dijalankan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.
- Name
500 - Internal Server Error- Description
Meshy mengalami ralat pelayan, contohnya kerana ia tidak dapat menjalankan semakan harta intelek pada imej tersebut. Meshy tidak mencipta tugas tersebut, dan memulangkan semula sebarang kredit yang telah dicaj. Cuba semula permintaan tersebut.
Cipta tugas pembinaan Brick Figure
Menjana minifigure 3D bertekstur daripada tugas prototaip yang berjaya. Untuk medannya, lihat The Brick Figure build task object.
Request
# Stage 2: chain build off a succeeded prototype task
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"
}
Parameter
- Name
- input_task_id
- Type
- string
- Diperlukan
- Description
ID tugas prototaip yang hendak dibina. Ia mestilah tugas yang dicipta oleh akaun anda dengan
POST /openapi/creative-lab/brick-figure/v1/prototype, dengan statusSUCCEEDED.ID yang bukan daripada tugas prototaip Brick Figure anda daripada API akan memulangkan
404, termasuk prototaip yang dibuat dalam aplikasi web.
- Name
- name
- Type
- string
- Description
Nama untuk tugas tersebut, sehingga 100 aksara. Ia akan dikembalikan dalam medan
nametugas tersebut. Nama yang lebih panjang akan memulangkan400.
Pulangan
Medan result menyimpan ID tugas pembinaan baharu. Dapatkan tugas atau strimkannya sehingga status adalah SUCCEEDED. Kemudian muat turun GLB bertekstur daripada model_urls.glb. Untuk OBJ pula, muat turun model_urls.obj beserta fail bahannya daripada model_urls.mtl.
Mod kegagalan
- Name
400 - Bad Request- Description
Permintaan tidak dapat dijalankan. Contohnya:
input_task_idtiada atau bukan ID tugas yang sah.- Status tugas prototaip bukan
SUCCEEDED. Jika ia masih berjalan, tunggu dan cuba lagi. Jika ia gagal atau dibatalkan, cipta tugas prototaip baharu. - Tugas prototaip berjaya tetapi tiada imej. Cipta tugas prototaip baharu.
Mesej ralat menyatakan masalah yang ditemui.
- Name
401 - Unauthorized- Description
Kunci API tiada atau tidak sah. Semak pengepala
Authorization.
- Name
402 - Payment Required- Description
Salah satu daripada perkara berikut berlaku:
- Akaun tidak mempunyai kredit yang mencukupi.
- Kunci API, ruang kerja, atau ahli telah mencapai had kreditnya.
- Akaun berada pada pelan percuma.
Semak kredit dan pelan anda, kemudian cuba lagi.
- Name
404 - Not Found- Description
input_task_idtidak sepadan dengan mana-mana tugas prototaip Brick Figure yang dicipta oleh akaun anda melalui API. Prototaip yang dibuat dalam aplikasi web juga akan memulangkan404. Hantar IDresultdaripada respons penciptaan prototaip.
- Name
429 - Too Many Requests- Description
Salah satu had berikut telah dicapai:
- Anda menghantar lebih banyak permintaan daripada yang dibenarkan oleh had kadar anda. Tunggu beberapa saat, kemudian cuba lagi. Lihat Rate limits.
- Terlalu banyak tugas anda sedang beratur atau berjalan. Tunggu sehingga sebahagiannya selesai, kemudian cuba lagi.
- Pada pelan tanpa had dengan tiada kredit berbaki, anda telah mencapai bilangan tugas yang boleh dijalankan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.
Dapatkan tugas Brick Figure
Mengembalikan tugas prototype atau build. Laluan mesti sepadan dengan peringkat tugas tersebut. Tugas build yang diminta melalui /prototype/:id akan mengembalikan 404, begitu juga dengan tugas prototype yang diminta melalui /build/:id.
Untuk medan-medan, lihat Objek tugas prototype Brick Figure dan Objek tugas build Brick Figure.
Request
# 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=***"
}
]
}
Parameter
- Name
- id
- Type
- path
- Description
ID tugas daripada respons create.
Pulangan
Objek tugas prototype atau objek tugas build, sepadan dengan peringkat dalam laluan tersebut.
Mod kegagalan
- Name
400 - Bad Request- Description
idbukan ID tugas yang sah. Hantar IDresultdaripada respons create.
- Name
403 - Forbidden- Description
Pasukan anda telah mengaktifkan IP Filtering, dan Meshy telah menandakan imej tugas tersebut kerana hak harta intelek pihak ketiga. Pasukan pada pelan Enterprise tidak mendapat ralat ini. Cipta tugas prototype daripada imej yang anda mempunyai hak untuk menggunakannya.
- Name
404 - Not Found- Description
Tiada tugas Brick Figure dengan ID ini yang dimiliki oleh akaun anda, atau peringkat tugas tidak sepadan dengan laluan tersebut. Semak ID, dan gunakan
/prototypeatau/builduntuk memadankan tugas tersebut.
- Name
500 - Internal Server Error- Description
Meshy tidak dapat menjalankan semakan harta intelek. Cuba semula permintaan tersebut.
Padam tugas Brick Figure
Membatalkan tugas Brick Figure. Membatalkan tugas PENDING akan mengembalikan kreditnya. Tugas IN_PROGRESS dibatalkan tanpa bayaran balik, kerana pekerja sudah pun memulakannya. Tugas yang mempunyai status akhir (SUCCEEDED, FAILED, atau CANCELED) tidak boleh dibatalkan.
Laluan mesti sepadan dengan peringkat tugas tersebut. Sebagai contoh, DELETE pada /prototype/:id dengan ID tugas build akan memulangkan 404.
Request
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}"
Response
// Returns 204 No Content on success (empty body).
Parameter laluan
- Name
- id
- Type
- path
- Description
ID tugas yang hendak dibatalkan.
Pulangan
204 No Content dengan badan kosong.
Mod kegagalan
- Name
400 - Bad Request- Description
Salah satu daripada berikut berlaku:
idbukan ID tugas yang sah. Hantar IDresultdaripada respons penciptaan.- Tugas tersebut sudah mempunyai status akhir (
SUCCEEDED,FAILED, atauCANCELED), jadi ia tidak boleh dibatalkan.
- Name
404 - Not Found- Description
Tiada tugas Brick Figure dengan ID ini yang dimiliki oleh akaun anda, atau peringkat tugas tersebut tidak sepadan dengan laluan. Semak ID, dan gunakan
/prototypeatau/builduntuk memadankan tugas tersebut.
Stream Tugasan Brick Figure
Menstrim kemas kini tugasan Brick Figure sebagai Server-Sent Events (SSE). Laluan mesti sepadan dengan peringkat tugasan tersebut. Jika tidak, contohnya ID tugasan build pada /prototype/:id/stream, stream akan menghantar satu acara error dengan status_code: 404 dan ditutup.
Request
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
// 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.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is shortened to the fields that change.
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=***"
}
]
}
Parameter
- Name
- id
- Type
- path
- Description
ID tugasan daripada respons create.
Pulangan
Satu stream objek tugasan prototype atau build. Setiap acara mengandungi objek tugasan penuh, seperti yang dikembalikan oleh Get a Brick Figure task. Semasa tugasan berstatus PENDING atau IN_PROGRESS, medan outputnya masih kosong (null, [], atau {}), dan finished_at adalah null.
Jika IP Filtering menyekat hasil tugasan, stream akan menghantar satu acara error sebagai gantinya, dengan status_code yang sama seperti yang akan dikembalikan oleh permintaan get.
Senaraikan tugas Brick Figure
Mengembalikan tugas Brick Figure anda bagi satu peringkat, satu halaman pada satu masa. Laluan tersebut memilih peringkat. /prototype mengembalikan hanya tugas prototaip, dan /build mengembalikan hanya tugas pembinaan.
Request
# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
# List build tasks
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=***"
]
}
]
Parameter laluan
- Name
- stage
- Type
- path
- Diperlukan
- Description
Peringkat untuk disenaraikan,
prototypeataubuild.
Parameter pertanyaan
- Name
- page_num
- Type
- integer
- lalai 1
- Description
Halaman yang hendak dikembalikan, dari
1hingga255.0mengembalikan halaman pertama. Nilai di luar0hingga255akan mengembalikan400.
- Name
- page_size
- Type
- integer
- lalai 10
- Description
Bilangan tugas setiap halaman, sehingga
100. Nilai dari101hingga255mengembalikan 100 tugas, dan0menggunakan lalai. Nilai di luar0hingga255akan mengembalikan400.
- Name
- sort_by
- Type
- string
- lalai -created_at
- Description
Susunan isihan.
Nilai yang tersedia:
-created_at: terbaharu dahulu+created_at: terlama dahulu
Pulangan
Satu tatasusunan objek tugas prototaip atau objek tugas pembinaan, sepadan dengan peringkat dalam laluan.
Objek tugas prototaip Figura Bata
Tugas prototaip menjana imej konsep gaya bata daripada sebuah foto. Untuk menukar imej itu kepada model 3D, hantarkan ID tugas tersebut ke build endpoint sebagai input_task_id.
Properties
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=***"
]
}
- Name
- id
- Type
- string
- Description
ID tugas. Jangan bergantung pada formatnya.
- Name
- type
- Type
- string
- Description
Jenis tugas, sentiasa
creative-lab-brick-figure-prototype.
- Name
- name
- Type
- string
- Description
nameyang anda hantar semasa membuat tugas tersebut, atau""jika anda tidak menghantarnya.
- Name
- status
- Type
- string
- Description
Status tugas.
Nilai yang tersedia:
PENDING: menunggu dalam baris gilirIN_PROGRESS: sedang menjana hasilSUCCEEDED: muktamad, dengan hasilFAILED: muktamad, dengan sebab dalamtask_errorCANCELED: muktamad, tanpa hasil
- Name
- progress
- Type
- integer
- Description
Peratusan kerja yang telah selesai, dari
0hingga100. Nilainya0sehingga tugas bermula dan100apabila berjaya.
- Name
- created_at
- Type
- timestamp
- Description
Masa tugas dicipta, dalam milisaat Unix.
- Name
- started_at
- Type
- timestamp
- Description
Masa seorang pekerja memulakan tugas, dalam milisaat Unix.
nullsehingga itu.
- Name
- finished_at
- Type
- timestamp
- Description
Masa tugas mencapai status muktamad, dalam milisaat Unix.
nullsehingga itu.
- Name
- expires_at
- Type
- timestamp
- Description
Masa hasil tugas tamat tempoh, dalam milisaat Unix. Ia adalah 3 hari selepas
finished_at, atau 3 hari selepascreated_atsehingga tugas selesai. Untuk akaun Enterprise, yang menyimpan hasil API tanpa had masa, ia adalah lebih kurang 100 tahun kemudian. Lihat Asset retention.
- Name
- preceding_tasks
- Type
- integer
- Description
Kedudukan tugas dalam baris gilir semasa ia
PENDING.1bermaksud ia akan bermula seterusnya.0selepas tugas meninggalkan baris gilir, dan sentiasa0dalam hasil senarai.
- Name
- task_error
- Type
- object
- Description
Sebab tugas gagal.
nullkecualistatusadalahFAILED. Lihat Errors.
- Name
- consumed_credits
- Type
- integer
- Description
Bilangan kredit yang dikenakan untuk tugas tersebut, selepas sebarang bayaran balik. Permintaan yang mengembalikan ralat tidak dikenakan caj. Tugas yang gagal adalah
0, kerana Meshy membayar baliknya. Membatalkan tugas hanya membayar balik semasa ia masihPENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan mengetepikan medan ini, dan permintaan senarai akan mengembalikan500. Dalam kes itu, cuba semula permintaan tersebut.
- Name
- image_urls
- Type
- array of strings
- Description
URL muat turun untuk imej konsep. Tatasusunan ini mempunyai satu URL selepas tugas berjaya, dan kosong sehingga itu.
Objek tugas pembinaan Brick Figure
Tugas pembinaan menghasilkan minifigure 3D bertekstur daripada tugas prototaip yang berjaya. Medan model_urls, thumbnail_url, dan texture_urls mempunyai format yang sama seperti dalam objek tugas Imej ke 3D.
Ciri-ciri
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=***"
}
]
}
- Name
- id
- Type
- string
- Description
ID tugas. Jangan bergantung pada formatnya.
- Name
- type
- Type
- string
- Description
Jenis tugas, sentiasa
creative-lab-brick-figure-build.
- Name
- name
- Type
- string
- Description
nameyang anda hantar semasa mencipta tugas, atau""jika anda tidak menghantarnya.
- Name
- status
- Type
- string
- Description
Status tugas.
Nilai yang tersedia:
PENDING: menunggu dalam baris gilirIN_PROGRESS: menjana hasilSUCCEEDED: muktamad, dengan hasilFAILED: muktamad, dengan sebab dalamtask_errorCANCELED: muktamad, tanpa hasil
- Name
- progress
- Type
- integer
- Description
Peratusan kerja yang selesai, dari
0hingga100. Ia adalah0sehingga tugas bermula dan100apabila berjaya.
- Name
- created_at
- Type
- timestamp
- Description
Masa tugas dicipta, dalam milisaat Unix.
- Name
- started_at
- Type
- timestamp
- Description
Masa pekerja memulakan tugas, dalam milisaat Unix.
nullsehingga itu.
- Name
- finished_at
- Type
- timestamp
- Description
Masa tugas mencapai status muktamad, dalam milisaat Unix.
nullsehingga itu.
- Name
- expires_at
- Type
- timestamp
- Description
Masa hasil tugas tamat tempoh, dalam milisaat Unix. Ia adalah 3 hari selepas
finished_at, atau 3 hari selepascreated_atsehingga tugas selesai. Untuk akaun Enterprise, yang menyimpan hasil API secara kekal, ia adalah lebih kurang 100 tahun kemudian. Lihat Pengekalan aset.
- Name
- preceding_tasks
- Type
- integer
- Description
Kedudukan tugas dalam baris gilir semasa ia
PENDING.1bermaksud ia bermula seterusnya.0selepas tugas keluar daripada baris gilir, dan sentiasa0dalam hasil senarai.
- Name
- task_error
- Type
- object
- Description
Sebab tugas gagal.
nullkecualistatusadalahFAILED. Lihat Ralat.
- Name
- consumed_credits
- Type
- integer
- Description
Bilangan kredit yang dicaj untuk tugas, selepas sebarang bayaran balik. Permintaan yang mengembalikan ralat tidak dicaj. Tugas yang gagal adalah
0, kerana Meshy membayar baliknya. Membatalkan hanya membayar balik tugas semasa iaPENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan meninggalkan medan tersebut, dan permintaan senarai akan mengembalikan500. Dalam kes itu, cuba semula permintaan tersebut.
- Name
- prompt
- Type
- string
- Description
Sentiasa
""untuk tugas pembinaan Brick Figure.
- Name
- negative_prompt
- Type
- string
- Description
Sentiasa
""untuk tugas pembinaan Brick Figure, sepertiprompt.
- Name
- texture_prompt
- Type
- string
- Description
Sentiasa
""untuk tugas pembinaan Brick Figure, sepertiprompt.
- Name
- texture_image_url
- Type
- string
- Description
Sentiasa
""untuk tugas pembinaan Brick Figure, sepertiprompt.
- Name
- model_urls
- Type
- object
- Description
URL muat turun untuk model 3D, sebagai GLB bertekstur dan sebagai fail OBJ dengan fail MTL-nya.
- Name
glb- Type
- string
- Description
URL muat turun untuk fail GLB bertekstur.
- Name
obj- Type
- string
- Description
URL muat turun untuk fail OBJ, dengan geometri dan UV.
- Name
mtl- Type
- string
- Description
URL muat turun untuk fail bahan MTL yang berpasangan dengan
obj. Gunakannya denganobjdan tekstur dalamtexture_urls[0].base_color.
- Name
- thumbnail_url
- Type
- string
- Description
URL muat turun untuk imej pratonton model.
- Name
- texture_urls
- Type
- array
- Description
Peta tekstur, sebagai tatasusunan dengan satu objek yang menyimpan peta warna asas.
- Name
base_color- Type
- string
- Description
URL muat turun untuk peta warna asas.