Ralat

Ketahui sebab permintaan atau tugas gagal, dan apa yang perlu dilakukan seterusnya. Sesuatu permintaan boleh gagal serta-merta dengan ralat HTTP, dan sesuatu tugas boleh gagal kemudian dengan task_error.

Ralat permintaan

Meshy mengembalikan ralat ini dengan segera, apabila ia menolak permintaan. Untuk mengetahui apa yang tidak kena, semak kod status HTTP dan medan message.

{
  "message": "Invalid model file extension: .3dm"
}

Ralat tugasan

Tugasan yang dicipta oleh Meshy masih boleh gagal semasa ia berjalan. status-nya menjadi FAILED, Meshy memulangkan kredit tugasan tersebut, dan task_error menerangkan sebabnya.

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "FAILED",
  "task_error": {
    "type": "invalid_input",
    "code": "image_too_complex",
    "message": "The uploaded image is too complex for 3D generation.",
    "doc_url": "https://docs.meshy.ai/en/api/errors#image-too-complex"
  }
}

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "FAILED",
  "task_error": {
    "type": "server_error",
    "message": "An internal error occurred. Please retry."
  }
}

Jenis ralat

type ialah kategori luas kegagalan. Gunakannya untuk menentukan apa yang perlu dilakukan seterusnya.

Kod ralat

Apabila code hadir, ia menamakan salah satu masalah berikut.

image_too_complex

Imej input atau prompt menggambarkan subjek yang terlalu kompleks dari segi geometri untuk penjanaan 3D.

Sebagai contoh:

• Timbunan padat objek kecil, seperti peti penuh dengan buah-buahan atau tindanan buku
• Corak berulang yang rumit, seperti struktur kekisi, perancah, atau jaring dawai
• Bangunan kompleks, seperti bangunan berbilang tingkat dengan banyak tingkap dan balkoni
• Beberapa objek berbeza dalam satu imej, bukannya satu subjek tunggal

Input berikut berkemungkinan terlalu kompleks:

Untuk membetulkannya, cuba satu atau lebih daripada yang berikut:

• Gunakan satu objek bagi setiap imej. Meshy berfungsi dengan paling baik dengan satu subjek yang jelas, jadi jangan letakkan beberapa objek berasingan dalam imej atau prompt yang sama.
• Permudahkan subjek anda. Sebagai contoh, gunakan vas ringkas berbanding vas yang dipenuhi dengan berpuluh-puluh bunga.
• Elakkan pemandangan. Keseluruhan bangunan, blok bandar, bilik berperabot, dan lanskap berkemungkinan terlalu banyak. Fokus pada satu objek tunggal.
• Elakkan struktur berulang yang padat. Perancah, jaring dawai, kekisi, dan timbunan item kecil adalah pencetus biasa.

model_missing_uv

Anda menghantar model untuk pembuatan tekstur dengan enable_original_uv ditetapkan kepada true, tetapi model tersebut tiada koordinat UV. Koordinat UV menentukan bagaimana tekstur 2D dibalut ke permukaan 3D.

Untuk membetulkannya, lakukan salah satu daripada perkara berikut:

• Untuk mengekalkan susun atur UV model anda sendiri, contohnya untuk penempatan sambungan (seam) tersuai, tambahkan UV pada model dalam perisian 3D anda. Semak UV tersebut dalam penyunting UV perisian itu, kemudian muat naik semula model tersebut. Fail STL tidak boleh menyimpan UV, jadi gunakan GLB, FBX, atau OBJ.
• Jika anda tidak memerlukan susun atur anda sendiri, atau tidak pasti, abaikan enable_original_uv atau tetapkannya kepada false. Meshy kemudiannya akan mencipta susun atur UV untuk model tersebut. UV baharu ini meliputi model dengan baik, tetapi anda tidak boleh mengawal di mana sambungan (seam) tekstur akan diletakkan.

model_insufficient_uv

Model mempunyai koordinat UV, tetapi ia hanya meliputi sebahagian kecil ruang UV sehingga tidak mencukupi untuk menghasilkan tekstur yang baik. Ini sering berlaku pada model yang pengeksportnya menulis UV placeholder atau UV yang runtuh tanpa unwrap yang betul.

Untuk membetulkannya, lakukan salah satu daripada perkara berikut:

• Untuk mengekalkan susun atur UV anda sendiri, unwrap semula koordinat UV model dalam perisian 3D anda. Sebarkan islands merentasi ruang UV dan bukannya hanya di satu sudut kecil sahaja.
• Jika anda tidak memerlukan susun atur anda sendiri, biarkan enable_original_uv atau tetapkannya kepada false. Meshy kemudian akan mencipta susun atur UV baharu. Anda akan kehilangan penempatan seam anda, tetapi UV baharu itu meliputi ruang yang mencukupi untuk tekstur.

model_missing_texture

Model input tugasan Multi-Color Print tidak mempunyai warna yang boleh dipisahkan oleh Meshy kepada warna cetakan. Meshy membina 3MF pelbagai warna daripada warna model tersebut, jadi jejaring putih polos tidak mempunyai apa-apa untuk diproses. Sebagai contoh, pratonton Teks ke 3D atau Imej ke 3D yang tidak pernah ditekstur tidak mempunyai warna. Begitu juga dengan output Baiki kebolehcetakan, atau tugasan Auto Split yang tidak mengekalkan tekstur.

Apa yang dikira sebagai warna bergantung kepada style yang anda minta:

• realistic mengambil sampel tekstur warna asas melalui UV model tersebut. Ia memerlukan satu tekstur warna asas, dan UV pada setiap bahagian jejaring.
• cartoon meratakan warna mengikut muka. Ia menerima tekstur warna asas pada mana-mana bahagian, atau warna per-verteks (COLOR_0).

Meshy menolak model yang tiada tekstur warna asas mahupun warna verteks untuk kedua-dua gaya, dan bukannya membiarkan cartoon menukarnya menjadi cetakan satu warna.

Meshy menolak kebanyakan permintaan ini sebelum ia mencipta tugasan, dengan 400 dan penjelasan yang sama. Anda biasanya hanya mendapat kod ini apabila Meshy tidak dapat menyemak input terlebih dahulu. Sebagai contoh, Meshy menyemak muat naik .fbx hanya selepas tugasan menukarnya.

Untuk membetulkannya, gunakan pilihan yang sesuai dengan model anda:

• Tekstur model terlebih dahulu. Jalankan Retekstur ke atasnya, atau janakannya dengan tugasan refine Teks ke 3D atau tugasan Imej ke 3D dengan should_texture: true. Kemudian hantar tugasan tersebut sebagai input_task_id.
• Untuk model berwarna verteks, seperti imbasan fotogrametri atau jejaring yang dicat tangan, gunakan style: "cartoon", yang membaca COLOR_0.
• Untuk model yang separa bertekstur atau pelbagai tekstur dengan realistic, berikan setiap bahagian jejaring UV dan tekstur warna asas tunggal yang sama. Untuk melakukan ini, tekstur bahagian yang selebihnya, atau gabungkan tekstur ke dalam satu atlas. Anda juga boleh bertukar kepada style: "cartoon".

textured_split_refused

Tugas Auto Split dengan keep_texture: true tidak dapat mengekalkan tekstur model input pada bahagian-bahagian tersebut. Contohnya, model tidak mempunyai UV, atau teksturnya tidak mempunyai ruang untuk permukaan baharu yang dihasilkan oleh potongan tersebut. Meshy akan memulangkan semula kredit.

Untuk membetulkannya, hantar semula permintaan tanpa keep_texture, atau dengan keep_texture: false. Bahagian-bahagian itu kemudiannya akan dikembalikan dengan satu warna rata bagi setiap satu.

invalid_input

Input gagal lulus pemeriksaan, dan tiada kod yang lebih khusus berkenaan. message memberikan sebabnya.

Contohnya:

• Fail model yang kosong atau rosak
• Varian format fail yang tidak disokong, seperti fail FBX ASCII atau fail GLB yang dimampatkan menggunakan meshopt
• Model yang dimuat naik tanpa sebarang objek 3D yang sah, contohnya fail yang hanya mengandungi armature, kamera, atau cahaya
• Kandungan yang tidak lulus penapis keselamatan

Untuk membetulkannya, baca message untuk mengetahui masalah khusus tersebut. Semak sama ada fail input dan parameter anda memenuhi keperluan endpoint tersebut.

moderation_blocked

Penapis keselamatan menolak prompt atau imej rujukan anda. Penapis menyemak teks dan imej secara bersama.

Untuk membetulkannya, lakukan satu atau kedua-dua perkara berikut:

• Ubah susunan ayat prompt untuk membuang penerangan yang bersifat lucah atau sensitif.
• Tukar imej rujukan yang memaparkan kandungan yang mungkin disekat oleh penapis.

moderation_unavailable

Jenis: server_error. moderation kandungan tidak tersedia buat sementara waktu, jadi Meshy menjadikan tugas tersebut FAILED dan bukannya melangkau semakan tersebut. Tiada apa-apa yang salah dengan kandungan anda.

Untuk membetulkannya, cipta semula tugas tersebut.

timeout

Tugas berjalan melepasi had masa di bahagian pelayan, sama ada untuk pemprosesan atau untuk menunggu dalam baris gilir, jadi Meshy menggagalkannya dan memulangkan semula kredit. Beban tinggi, atau input yang terlalu kompleks untuk diselesaikan tepat pada masanya, boleh menyebabkan ini.

Ini berbeza daripada timeout dalam kod anda sendiri. Jika klien anda berhenti menunggu, tugas tersebut masih berjalan. Lihat Berapa lama untuk menunggu.

Untuk membetulkannya, ikuti langkah-langkah berikut:

1. Cipta semula tugas tersebut. Timeout selalunya bersifat sementara, dan tugas baharu mungkin berjaya.
2. Jika ia terus gagal, permudahkan input anda, contohnya dengan mengurangkan perincian dalam imej atau prompt anda. Untuk input yang lebih sukar diproses, lihat image_too_complex.

queue_timeout

Jenis: timeout. Tugasan menunggu terlalu lama dalam baris gilir tanpa bermula, jadi Meshy menandakannya sebagai gagal dan memulangkan sebarang kredit yang dikenakan untuknya. Input anda tidak menyebabkan ralat ini.

Untuk membetulkannya, cipta semula tugasan tersebut.

format_conversion_failed

Meshy berjaya menjana model tersebut, tetapi penukarannya kepada format yang anda minta gagal.

Untuk membetulkannya, ikuti langkah-langkah berikut:

1. Cipta semula tugasan tersebut.
2. Jika satu format sentiasa gagal, mintalah format lain yang sesuai dengan keperluan anda.

Amalan terbaik

• Cuba semula tugas yang gagal. Untuk tugas yang gagal dengan timeout, service_unavailable, atau server_error, cipta tugas baharu dengan backoff eksponen.
• Jangan cipta tugas baharu apabila permintaan anda sendiri timeout. Tugas pertama mungkin masih berjalan, jadi semak sama ada ia wujud sebelum anda mencipta satu lagi. Lihat Berapa lama untuk menunggu.
• Log ID tugas. Sertakan ID tersebut apabila anda menghubungi sokongan.
• Semak input sebelum anda menghantarnya. Pastikan imej dan model memenuhi keperluan format endpoint tersebut.
• Panggil API dari pelayan anda. Kod yang dijalankan dalam pelayar mendedahkan kunci API anda kepada sesiapa sahaja yang membuka halaman tersebut.