Fel

Ta reda på varför en förfrågan eller en uppgift misslyckades, och vad du ska göra härnäst. En förfrågan kan misslyckas direkt med ett HTTP-fel, och en uppgift kan misslyckas senare med ett task_error.

Begäranfel

Meshy returnerar dessa fel direkt när en begäran avvisas. För att ta reda på vad som gick fel, kontrollera HTTP-statuskoden och fältet message.

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

Taskfel

Ett task som Meshy har skapat kan ändå misslyckas medan det körs. Dess status blir FAILED, Meshy återbetalar dess credits, och task_error förklarar varför.

{
  "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."
  }
}

Feltyper

type är den övergripande kategorin för felet. Använd den för att avgöra vad du ska göra härnäst.

Felkoder

När code är angivet anger den ett av följande problem.

image_too_complex

Indatabilden eller prompten beskriver ett motiv som är geometriskt för komplext för 3D-generering.

Till exempel:

• Täta högar av små objekt, till exempel en back full av frukt eller en bokstapel
• Invecklade repeterande mönster, till exempel gallerstrukturer, byggnadsställningar eller trådnät
• Komplexa byggnader, till exempel flervåningshus med många fönster och balkonger
• Flera distinkta objekt i en och samma bild, i stället för ett enda motiv

Dessa indata är troligen för komplexa:

Prova ett eller flera av följande för att åtgärda det:

• Använd ett objekt per bild. Meshy fungerar bäst med ett tydligt motiv, så undvik att ha flera separata objekt i samma bild eller prompt.
• Förenkla ditt motiv. Använd till exempel en enkel vas i stället för en vas fylld med dussintals blommor.
• Undvik scener. Hela byggnader, kvarter, möblerade rum och landskap är troligen för mycket. Fokusera på ett enskilt objekt.
• Undvik täta repeterande strukturer. Byggnadsställningar, trådnät, galler och högar av små föremål är vanliga utlösande faktorer.

model_missing_uv

Du skickade en modell för texturering med enable_original_uv satt till true, men modellen saknar UV-koordinater. UV-koordinater definierar hur en 2D-textur mappas mot 3D-ytan.

För att åtgärda det, gör något av följande:

• För att behålla modellens egen UV-layout, till exempel för anpassad placering av sömmar, lägg till UV:er på modellen i din 3D-mjukvara. Kontrollera dem i dess UV-editor, och ladda sedan upp modellen igen. STL-filer kan inte lagra UV:er, så använd GLB, FBX eller OBJ.
• Om du inte behöver din egen layout, eller om du är osäker, utelämna enable_original_uv eller sätt den till false. Meshy skapar då en UV-layout för modellen. De nya UV:erna täcker modellen väl, men du kan inte styra var textursömmarna hamnar.

model_insufficient_uv

Modellen har UV-koordinater, men de täcker för lite av UV-utrymmet för att texturera väl. Detta inträffar ofta med modeller vars exportör skrev platshållar- eller hopslagna UV:er utan en korrekt uppvikning.

För att åtgärda det, gör något av följande:

• För att behålla din egen UV-layout, vik upp modellens UV:er igen i din 3D-programvara. Sprid ut öarna över UV-utrymmet istället för i ett litet hörn av det.
• Om du inte behöver din egen layout, utelämna enable_original_uv eller sätt den till false. Meshy skapar då en ny UV-layout. Du förlorar din sömplacering, men de nya UV:erna täcker tillräckligt med utrymme för att texturera.

model_missing_texture

En indatamodell för en Multi-Color Print-uppgift har ingen färg som Meshy kan dela upp i utskriftsfärger. Meshy bygger en flerfärgs-3MF från modellens färger, så ett helt vitt nät har inget att arbeta med. Till exempel har en Text till 3D- eller Bild till 3D-förhandsgranskning som aldrig texturerats ingen färg. Detsamma gäller resultatet från Reparera utskrivbarhet, eller en Auto Split-uppgift som inte behöll texturen.

Vad som räknas som färg beror på vilken style du har begärt:

• realistic samplar bastexturen via modellens UV:er. Den kräver en enda bastextur och UV:er på varje nätdel.
• cartoon plattar till färger per yta. Den accepterar en bastextur på vilken del som helst, eller färger per vertex (COLOR_0).

Meshy avvisar en modell som varken har en bastextur eller vertexfärger för båda stilarna, istället för att låta cartoon göra om den till en enfärgad utskrift.

Meshy avvisar de flesta av dessa förfrågningar innan uppgiften skapas, med en 400 och samma förklaring. Du får vanligtvis bara den här koden när Meshy inte kan kontrollera indata i förväg. Till exempel kontrollerar Meshy en .fbx-uppladdning först efter att uppgiften har konverterat den.

För att åtgärda det, använd det alternativ som passar din modell:

• Texturera modellen först. Kör Omtexturering på den, eller generera den med en Text till 3D-refine-uppgift eller en Bild till 3D-uppgift med should_texture: true. Skicka sedan den uppgiften som input_task_id.
• För en vertexfärgad modell, till exempel en fotogrammetriskanning eller ett handmålat nät, använd style: "cartoon", som läser COLOR_0.
• För en delvis texturerad modell eller en modell med flera texturer och realistic, ge varje nätdel UV:er och samma enda bastextur. Gör det genom att texturera de återstående delarna, eller slå ihop texturerna till ett enda atlas. Du kan också byta till style: "cartoon".

textured_split_refused

En Auto Split-uppgift med keep_texture: true kan inte behålla indatamodellens textur på delarna. Till exempel saknar modellen UV:er, eller så finns det inget utrymme i dess textur för de nya ytor som snitten skapar. Meshy återbetalar credits.

För att åtgärda detta, skicka begäran igen utan keep_texture, eller med keep_texture: false. Delarna returneras då med en enfärgad färg vardera.

invalid_input

Indata klarade inte en kontroll, och ingen mer specifik kod gäller. message anger orsaken.

Till exempel:

• En tom eller skadad modellfil
• En variant av ett filformat som inte stöds, till exempel en ASCII FBX-fil eller en meshopt-komprimerad GLB-fil
• En uppladdad modell utan giltiga 3D-objekt, till exempel en fil som bara innehåller skelett (armatures), kameror eller ljuskällor
• Innehåll som inte klarar säkerhetsfiltren

För att åtgärda detta, läs message för att se det specifika problemet. Kontrollera att dina indatafiler och parametrar uppfyller endpointens krav.

moderation_blocked

Säkerhetsfiltren avvisade din prompt eller dina referensbilder. Filtren kontrollerar texten och bilderna tillsammans.

Gör en eller båda av följande för att åtgärda det:

• Omformulera prompten för att ta bort antydande eller känsliga beskrivningar.
• Byt ut referensbilder som visar innehåll som filtren kan blockera.

moderation_unavailable

Typ: server_error. Innehållsmoderering (moderation) var tillfälligt otillgänglig, så Meshy lät uppgiften misslyckas istället för att hoppa över kontrollen. Det är inget fel på ditt innehåll.

För att åtgärda det, skapa uppgiften igen.

timeout

Uppgiften körde längre än en serverseitig tidsgräns, antingen för bearbetning eller för väntan i kön, så Meshy avbröt den och återbetalade dess credits. Hög belastning, eller indata som är för komplex för att slutföras i tid, kan orsaka detta.

Detta skiljer sig från en timeout i din egen kod. Om din klient slutade vänta körs uppgiften fortfarande. Se Hur länge ska man vänta.

Gör så här för att åtgärda det:

1. Skapa uppgiften igen. Timeouts är ofta tillfälliga, och en ny uppgift kan lyckas.
2. Om det fortsätter att misslyckas, förenkla din indata, till exempel genom att minska detaljnivån i din bild eller prompt. För indata som är svårare att bearbeta, se image_too_complex.

queue_timeout

Typ: timeout. Uppgiften väntade för länge i kön utan att starta, så Meshy misslyckades med den och återbetalade eventuella credits som debiterats för den. Din indata orsakade inte detta fel.

För att åtgärda det, skapa uppgiften igen.

format_conversion_failed

Meshy genererade modellen, men konverteringen till ett format du begärde misslyckades.

För att åtgärda det, följ dessa steg:

1. Skapa uppgiften igen.
2. Om ett format fortsätter att misslyckas, begär ett annat format som passar dina behov.

Best practices

• Gör om misslyckade uppgifter. Vid en misslyckad uppgift med timeout, service_unavailable eller server_error, skapa en ny uppgift med exponentiell backoff.
• Skapa inte en ny uppgift när din egen förfrågan får timeout. Den första uppgiften kan fortfarande köras, så kontrollera om den finns innan du skapar en till. Se Hur länge du ska vänta.
• Logga uppgifts-ID:n. Inkludera ID:t när du kontaktar supporten.
• Kontrollera indata innan du skickar dem. Se till att bilder och modeller uppfyller endpointens formatkrav.
• Anropa API:et från din server. Kod som körs i en webbläsare exponerar din API-nyckel för alla som öppnar sidan.