API Lampu Creative Lab

Foto untuk dijadikan asas penutup lampu, sebagai URL awam atau Data URI (data:image/jpeg;base64,<data imej anda yang dienkod base64>).

Imej mestilah fail JPG, JPEG, PNG, atau WebP bersaiz paling banyak 20 MB.

Jenis subjek dalam foto, yang menetapkan cara Meshy menstailkannya.

Nilai yang tersedia:

• character: satu watak atau objek tunggal, seperti figura, haiwan, atau maskot
• landscape: adegan luar atau panorama, seperti gunung, pemandangan bandar, atau hutan

Nama untuk tugas, sehingga 100 aksara. Ia dikembalikan dalam medan name tugas. Nama yang lebih panjang mengembalikan 400.

Sama ada untuk membuang latar belakang dari imej prototaip. true mengembalikan PNG RGBA telus, supaya anda boleh meletakkan subjek pada sebarang latar belakang. Meshy juga membina model 3D daripada imej tanpa latar belakangnya. Jika Meshy tidak dapat membuang latar belakang, ia menggunakan imej dengan latar belakangnya, dan tugas masih berjaya.

Permintaan tidak dapat dijalankan. Sebagai contoh:

• image_url tiada.
• Imej bukan fail JPG, JPEG, PNG, atau WebP.
• Imej terlalu kecil, melebihi 20 MB, atau melebihi had bilangan piksel maksimum.
• Meshy tidak dapat memuat turun imej, contohnya kerana URL mengembalikan 404 atau tamat masa.
• Data URI bukan base64 yang sah.
• Imej telah ditandakan sebagai NSFW.
• image_subject bukan character atau landscape.

Mesej ralat menyatakan masalah yang ditemui. Betulkan permintaan, kemudian hantar semula.

Kunci API tiada atau tidak sah. Semak header Authorization.

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.

Pasukan anda telah menghidupkan IP Filtering, dan Meshy menandakan imej tersebut kerana harta intelek pihak ketiga. Hantar imej yang anda mempunyai hak untuk menggunakannya.

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 sebahagian selesai, kemudian cuba semula.
• Pada pelan tanpa had tanpa baki kredit, anda telah mencapai bilangan tugas yang boleh berjalan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.

Meshy mengalami ralat pelayan, contohnya kerana ia tidak dapat menjalankan semakan harta intelek pada imej. Meshy tidak mencipta tugas, dan memulangkan semula sebarang kredit yang telah dicaj. Cuba semula permintaan tersebut.

ID tugas prototaip untuk dibina. Ia mestilah tugas yang dicipta oleh akaun anda dengan POST /openapi/creative-lab/lamp/v1/prototype, dengan status SUCCEEDED.

ID yang bukan salah satu daripada tugas prototaip Lamp anda daripada API akan memulangkan 404, termasuk prototaip yang dibuat dalam aplikasi web.

Nama untuk tugas tersebut, sehingga 100 aksara. Ia akan dipulangkan dalam medan name tugas tersebut. Nama yang lebih panjang akan memulangkan 400.

Saiz dimensi terbesar kap lampu, dalam milimeter, dari 50 hingga 400. Meshy mengskala model secara seragam agar sesuai. 0 menggunakan nilai lalai, dan sebarang nilai lain di luar julat akan memulangkan 400.

Ketebalan dinding kap lampu, dalam milimeter, sehingga 10. 0 menggunakan nilai lalai, dan nilai negatif atau nilai melebihi 10 akan memulangkan 400.

Peratusan ketinggian model yang dipotong rata pada bahagian bawah, dari 1 hingga 100. Bahagian bawah rata membolehkan kap lampu duduk di atas katil cetak dan memberi ruang untuk kelengkapan. Nilai di luar julat akan memulangkan 400.

Prasetan kelengkapan lampu, yang menetapkan cara Meshy membina bahagian bawah.

Nilai yang tersedia:

• bambu_mh001_60mm: kap lampu berbahagian bawah terbuka dengan plat tapak yang mempunyai lubang kelengkapan 60 mm, kedua-duanya dalam model_urls.lamp_stl, dan gunungan kelengkapan dalam model_urls.base_stl
• none: satu kap lampu tertutup dalam model_urls.lamp_stl, tanpa model_urls.base_stl

Sejauh mana untuk menggerakkan lubang kelengkapan sepanjang paksi X daripada pusat kap lampu, dalam milimeter, dari -80 hingga 80. Hanya terpakai apabila light_source_preset bukan none.

Sejauh mana untuk menggerakkan lubang kelengkapan sepanjang paksi Z (kedalaman) daripada pusat kap lampu, dalam milimeter, dari -80 hingga 80. Hanya terpakai apabila light_source_preset bukan none.

Putaran mengelilingi paksi X yang digunakan pada model sebelum Meshy memprosesnya, dalam darjah, dari -360 hingga 360. Meshy menggunakan ketiga-tiga putaran sebagai sudut Euler XYZ mengelilingi pusat model.

Putaran mengelilingi paksi Y yang digunakan pada model sebelum Meshy memprosesnya, dalam darjah, dari -360 hingga 360.

Putaran mengelilingi paksi Z yang digunakan pada model sebelum Meshy memprosesnya, dalam darjah, dari -360 hingga 360.

Sama ada untuk menambah fail result.json ke dalam bungkusan zip, dengan nama talian pemprosesan yang dijalankan, amaran, dan laluan fail. Memerlukan output.format ditetapkan kepada zip. true dengan stl akan memulangkan 400.

Fail yang dipulangkan oleh pembinaan.

Nilai yang tersedia:

• stl: model_urls.lamp_stl, kap lampu beserta plat tapaknya apabila terdapat prasetan kelengkapan, dan model_urls.base_stl apabila light_source_preset bukan none
• zip: satu fail zip dalam model_urls.bundle_zip, dengan lamp.stl, dan base.stl serta result.json apabila berkenaan

Permintaan tidak dapat dijalankan. Contohnya:

• input_task_id tiada 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 model 3D. Cipta tugas prototaip baharu.
• Medan options berada di luar julatnya atau bukan nilai yang tersedia.
• output.format bukan stl atau zip, atau include_result_json adalah true tanpa zip.

Mesej ralat menyatakan masalah yang dijumpai.

Kunci API tiada atau tidak sah. Semak pengepala Authorization.

Salah satu daripada yang 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.

input_task_id tidak sepadan dengan mana-mana tugas prototaip Lamp yang dicipta oleh akaun anda dengan API. Prototaip yang dibuat dalam aplikasi web juga akan memulangkan 404. Hantar ID result daripada respons cipta prototaip.

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 Had kadar.
• Terlalu banyak tugas anda sedang beratur atau berjalan. Tunggu sehingga sebahagian selesai, kemudian cuba lagi.
• Pada pelan tanpa had dengan tiada kredit yang tinggal, anda telah mencapai bilangan tugas yang boleh berjalan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.

ID tugas daripada respons create.

id bukan ID tugas yang sah. Hantar ID result daripada respons create.

Pasukan anda telah mengaktifkan IP Filtering, dan Meshy menandakan imej tugas prototype itu untuk harta intelek pihak ketiga. Tugas build dan pasukan pada pelan Enterprise tidak akan mendapat ralat ini. Cipta tugas prototype daripada imej yang anda mempunyai hak untuk menggunakannya.

Tiada tugas Lamp dengan ID ini milik akaun anda, atau peringkat tugas tidak sepadan dengan laluan tersebut. Semak ID, dan gunakan /prototype atau /build untuk memadankan tugas tersebut.

Meshy tidak dapat menjalankan semakan harta intelek. Cuba semula permintaan tersebut.

ID tugas yang hendak dibatalkan.

Salah satu daripada berikut berlaku:

• id bukan ID tugas yang sah. Hantar ID result daripada respons penciptaan.
• Tugas tersebut sudah mempunyai status akhir (SUCCEEDED, FAILED, atau CANCELED), jadi ia tidak boleh dibatalkan.

Tiada tugas Lamp dengan ID ini yang dimiliki oleh akaun anda, atau peringkat tugas tidak sepadan dengan laluan. Semak ID tersebut, dan gunakan /prototype atau /build untuk memadankan tugas berkenaan.

ID tugas daripada respons create.

Peringkat yang hendak disenaraikan, prototype atau build.

Halaman yang hendak dikembalikan, dari 1 hingga 255. 0 mengembalikan halaman pertama. Nilai di luar 0 hingga 255 akan mengembalikan 400.

Bilangan tugas setiap halaman, sehingga 100. Nilai dari 101 hingga 255 mengembalikan 100 tugas, dan 0 menggunakan nilai lalai. Nilai di luar 0 hingga 255 akan mengembalikan 400.

Susunan isihan.

Nilai yang tersedia:

• -created_at: terbaharu dahulu
• +created_at: terlama dahulu

ID tugas. Jangan bergantung pada formatnya.

Jenis tugas, sentiasa creative-lab-lamp-prototype.

name yang anda hantar semasa mencipta tugas, atau "" jika anda tidak menghantarnya.

Status tugas.

Nilai yang tersedia:

• PENDING: menunggu dalam baris gilir
• IN_PROGRESS: sedang menjana hasil
• SUCCEEDED: muktamad, dengan hasil
• FAILED: muktamad, dengan sebab dalam task_error
• CANCELED: muktamad, tanpa hasil

Peratusan kerja yang telah selesai, dari 0 hingga 100. Nilainya 0 sehingga tugas bermula dan 100 apabila ia berjaya.

Masa tugas dicipta, dalam milisaat Unix.

Masa seorang pekerja memulakan tugas, dalam milisaat Unix. null sehingga itu.

Masa tugas mencapai status muktamad, dalam milisaat Unix. null sehingga itu.

Masa hasil tugas tamat tempoh, dalam milisaat Unix. Ia adalah 3 hari selepas finished_at, atau 3 hari selepas created_at sehingga tugas selesai. Bagi akaun Enterprise, yang menyimpan hasil API secara berkekalan, ia adalah kira-kira 100 tahun kemudian. Lihat Pengekalan aset.

Kedudukan tugas dalam baris gilir semasa ia PENDING. 1 bermaksud ia bermula seterusnya. 0 selepas tugas keluar dari baris gilir, dan sentiasa 0 dalam hasil senarai.

Sebab tugas gagal. null kecuali status ialah FAILED. Lihat Ralat.

Bilangan kredit yang dicaj untuk tugas tersebut, 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 ia PENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan meninggalkan medan tersebut, dan permintaan senarai akan mengembalikan 500. Dalam kes itu, cuba semula permintaan tersebut.

URL muat turun untuk model 3D yang dijana daripada imej konsep. {} sehingga tugas berjaya.

URL muat turun untuk imej pratonton model 3D. "" sehingga tugas berjaya.

URL muat turun untuk imej konsep. Tatasusunan ini mempunyai satu URL selepas tugas berjaya, dan kosong sehingga itu.

ID tugas. Jangan bergantung pada formatnya.

Jenis tugas, sentiasa creative-lab-lamp-build.

name yang anda hantar semasa mencipta tugas, atau "" jika anda tidak menghantarnya.

Status tugas.

Nilai yang tersedia:

• PENDING: menunggu dalam baris gilir
• IN_PROGRESS: menjana hasil
• SUCCEEDED: muktamad, dengan hasil
• FAILED: muktamad, dengan sebab dalam task_error
• CANCELED: muktamad, tanpa hasil

Peratusan kerja yang selesai, daripada 0 hingga 100. Nilainya 0 sehingga tugas bermula dan 100 apabila ia berjaya.

Masa tugas dicipta, dalam milisaat Unix.

Masa seorang pekerja memulakan tugas, dalam milisaat Unix. null sehingga itu.

Masa tugas mencapai status muktamad, dalam milisaat Unix. null sehingga itu.

Masa hasil tugas tamat tempoh, dalam milisaat Unix. Nilainya 3 hari selepas finished_at, atau 3 hari selepas created_at sehingga tugas selesai. Untuk akaun Enterprise, yang menyimpan hasil API tanpa had masa, nilainya kira-kira 100 tahun kemudian. Lihat Pengekalan aset.

Kedudukan tugas dalam baris gilir semasa ia PENDING. 1 bermaksud ia bermula seterusnya. 0 selepas tugas keluar daripada baris gilir, dan sentiasa 0 dalam hasil senarai.

Sebab tugas gagal. null kecuali status ialah FAILED. Lihat Ralat.

Bilangan kredit yang dicaj untuk tugas tersebut, selepas sebarang bayaran balik. Permintaan yang memulangkan ralat tidak dicaj. Tugas yang gagal adalah 0, kerana Meshy membayar baliknya. Membatalkan hanya membayar balik tugas semasa ia PENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan meninggalkan medan ini, dan permintaan senarai akan memulangkan 500. Dalam kes itu, cuba semula permintaan tersebut.

URL muat turun untuk fail boleh cetak. Kunci yang muncul bergantung pada output.format dan options.light_source_preset.