API Figura Vinil Creative Lab
Tukarkan foto menjadi figura vinil koleksi 3D berkepala besar dalam dua peringkat. Tugas prototaip menjana imej konsep daripada foto tersebut. Tugas bina menukarkan imej itu menjadi model 3D bertekstur, dan mengambil ID tugas prototaip sebagai input_task_id.
POST /openapi/creative-lab/vinyl-figure/v1/prototypePOST /openapi/creative-lab/vinyl-figure/v1/build
Cipta tugas prototaip Vinyl Figure
Menjana satu imej konsep bergaya vinyl-figure daripada sekeping foto. Untuk membina model 3D, hantar ID tugas ini ke build endpoint sebagai input_task_id. Untuk medan tugas ini, lihat The Vinyl Figure prototype task object.
Request
# 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"
}
Parameter
- Name
- image_url
- Type
- string
- Diperlukan
- Description
Foto yang hendak ditukar menjadi vinyl figure berkepala besar, sebagai URL awam atau data URI (
data:image/jpeg;base64,<data imej anda yang dikod 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 hendak membuang latar belakang daripada imej prototaip.
truemengembalikan PNG RGBA telus, supaya anda boleh meletakkan subjek pada sebarang latar belakang. Proses pembinaan juga bermula daripada imej tanpa latar belakangnya. Jika Meshy tidak dapat membuang latar belakang, ia 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 ditandakan 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 kreditnya.
- 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 menandakan imej tersebut kerana hak harta intelek pihak ketiga. Hantar imej yang anda mempunyai hak untuk menggunakannya.
- 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 Had Kadar.
- Terlalu banyak tugas anda sedang beratur atau berjalan. Tunggu sehingga sebahagiannya selesai, kemudian cuba semula.
- Pada pelan tanpa had tanpa kredit yang berbaki, anda telah mencapai bilangan tugas yang boleh berjalan tanpa kredit. Tunggu 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 Vinyl Figure
Menjana figura vinyl 3D bertekstur daripada tugas prototaip yang berjaya. Untuk medannya, lihat Objek tugas pembinaan Vinyl Figure.
Request
# 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"
}
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/vinyl-figure/v1/prototype, dengan statusSUCCEEDED.ID yang bukan tugas prototaip Vinyl Figure anda daripada API akan mengembalikan
404, termasuk prototaip yang dibuat dalam aplikasi web.
- Name
- name
- Type
- string
- Description
Nama untuk tugas, sehingga 100 aksara. Ia akan dikembalikan dalam medan
nametugas tersebut. Nama yang lebih panjang akan mengembalikan400.
Pulangan
Medan result menyimpan ID tugas pembinaan baharu. Dapatkan tugas tersebut atau strim tugas tersebut sehingga status menjadi 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 semula. Jika ia gagal atau dibatalkan, cipta tugas prototaip baharu. - Tugas prototaip berjaya tetapi tiada imej. Cipta tugas prototaip baharu.
Mesej ralat menyatakan masalah yang ditemuinya.
- 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 kreditnya.
- Akaun berada pada pelan percuma.
Semak kredit dan pelan anda, kemudian cuba semula.
- Name
404 - Not Found- Description
input_task_idtidak sepadan dengan mana-mana tugas prototaip Vinyl Figure yang dicipta oleh akaun anda melalui API. Prototaip yang dibuat dalam aplikasi web juga akan mengembalikan404. 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 semula. Lihat Had kadar.
- Terlalu banyak tugas anda sedang dalam baris gilir 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.
Dapatkan tugas Vinyl Figure
Mengembalikan tugas prototype atau build. Laluan (path) mesti sepadan dengan peringkat tugas tersebut. Tugas build yang diminta melalui /prototype/:id akan mengembalikan 404, begitu juga tugas prototype yang diminta melalui /build/:id.
Untuk medan-medannya, lihat Objek tugas prototype Vinyl Figure dan Objek tugas build Vinyl Figure.
Request
# 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=***"
}
]
}
Parameter
- Name
- id
- Type
- path
- Description
ID tugas daripada respons create.
Nilai yang Dikembalikan
Objek tugas prototype atau objek tugas build, bergantung kepada peringkat yang sepadan dengan 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 ini atas sebab harta intelek pihak ketiga. Pasukan dalam pelan Enterprise tidak akan menerima ralat ini. Cipta tugas prototype daripada imej yang anda mempunyai hak untuk menggunakannya.
- Name
404 - Not Found- Description
Tiada tugas Vinyl Figure dengan ID ini yang dimiliki oleh akaun anda, atau peringkat tugas tersebut tidak sepadan dengan laluan. Semak ID tersebut, dan gunakan
/prototypeatau/builduntuk sepadan dengan tugas tersebut.
- Name
500 - Internal Server Error- Description
Meshy tidak dapat menjalankan semakan harta intelek. Cuba semula permintaan tersebut.
Padam tugas Vinyl Figure
Membatalkan tugas Vinyl Figure. Membatalkan tugas PENDING akan memulangkan semula 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 tersebut mesti sepadan dengan peringkat tugas. 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/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
// Returns 204 No Content on success (empty body).
Parameter laluan
- Name
- id
- Type
- path
- Description
ID bagi tugas yang hendak dibatalkan.
Nilai 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 Vinyl 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.
Strim tugas Vinyl Figure
Menstrim kemas kini tugas Vinyl Figure sebagai Server-Sent Events (SSE). Laluan mesti sepadan dengan peringkat tugas tersebut. Jika tidak, contohnya ID tugas build pada /prototype/:id/stream, strim tersebut menghantar satu peristiwa error dengan status_code: 404 dan ditutup.
Request
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.
// 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": "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=***"
}
]
}
Parameter
- Name
- id
- Type
- path
- Description
ID tugas daripada respons create.
Nilai Kembali
Satu strim objek tugas prototype atau build. Setiap peristiwa mengandungi objek tugas yang lengkap, seperti yang dikembalikan oleh Get a Vinyl Figure task. Semasa tugas berstatus PENDING atau IN_PROGRESS, medan outputnya masih kosong (null, [], atau {}), dan finished_at adalah null.
Jika IP Filtering menyekat hasil tugas, strim tersebut menghantar satu peristiwa error sebagai gantinya, dengan status_code yang akan dikembalikan oleh permintaan get.
Senaraikan tugas Vinyl Figure
Mengembalikan tugas Vinyl Figure anda bagi satu peringkat, satu halaman pada satu masa. Laluan menentukan peringkat tersebut. /prototype hanya mengembalikan tugas prototype, dan /build hanya mengembalikan tugas build.
Request
# 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=***"
]
}
]
Parameter laluan
- Name
- stage
- Type
- path
- Diperlukan
- Description
Peringkat yang ingin 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 nilai 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
Kembalian
Satu tatasusunan objek tugas prototype atau objek tugas build, mengikut peringkat dalam laluan tersebut.
Objek tugas prototaip Figura Vinil
Tugas prototaip menjana imej konsep gaya figura vinil daripada foto. Untuk menukar imej itu menjadi model 3D, hantar ID tugas tersebut ke endpoint build sebagai input_task_id.
Properties
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=***"
]
}
- Name
- id
- Type
- string
- Description
ID tugas. Jangan bergantung pada formatnya.
- Name
- type
- Type
- string
- Description
Jenis tugas, sentiasa
creative-lab-vinyl-figure-prototype.
- 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: 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. Bagi akaun Enterprise, yang menyimpan hasil API secara berkekalan, 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 akan 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 dikenakan untuk tugas, selepas sebarang bayaran balik. Permintaan yang mengembalikan ralat tidak dikenakan caj. 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
- 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 binaan Figura Vinil
Tugas binaan menjana figura vinil 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.
Sifat
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=***"
}
]
}
- Name
- id
- Type
- string
- Description
ID tugas. Jangan bergantung pada formatnya.
- Name
- type
- Type
- string
- Description
Jenis tugas, sentiasa
creative-lab-vinyl-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. Nilainya0sehingga tugas bermula dan100apabila ia 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 Pengekalan aset.
- Name
- preceding_tasks
- Type
- integer
- Description
Kedudukan tugas dalam baris gilir semasa ia
PENDING.1bermaksud ia bermula seterusnya.0selepas tugas meninggalkan 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 membayar balik tugas hanya semasa iaPENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan meninggalkan medan ini, dan permintaan senarai akan mengembalikan500. Dalam kes itu, cuba semula permintaan tersebut.
- Name
- prompt
- Type
- string
- Description
Sentiasa
""untuk tugas binaan Figura Vinil.
- Name
- negative_prompt
- Type
- string
- Description
Sentiasa
""untuk tugas binaan Figura Vinil, sepertiprompt.
- Name
- texture_prompt
- Type
- string
- Description
Sentiasa
""untuk tugas binaan Figura Vinil, sepertiprompt.
- Name
- texture_image_url
- Type
- string
- Description
Sentiasa
""untuk tugas binaan Figura Vinil, 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 berpadanan dengan
obj. Gunakannya bersamaobjdan 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.