lowpoly bude vyřazen 30. 10. 2026. Před těmito daty přejděte na jiný model, abyste předešli chybám požadavků. Zobrazit všechna ukončení podpory

Analyze Printability API

Zkontrolujte 3D model na problémy s tiskem měřením jeho vodotěsnosti, objemu, otvorů, non-manifold hran a degenerovaných ploch. Můžete také zkontrolovat tloušťku stěny při velikosti, ve které plánujete tisk.


POST/openapi/v1/print/analyze

Create an Analyze Printability task

Vytvoří úlohu Analyzovat tisknutelnost, která vyhodnotí 3D model a vrátí ukazatele jeho tisknutelnosti. Úloha běží na pozadí. Jak dlouho úloha obvykle trvá, zjistíte v sekci Doby zpracování.

Pokud už Meshy má výsledek tisknutelnosti pro úlohu uvedenou v input_task_id, je nová úloha připravená ihned. Při prvním GET dotazu na ni získáte výsledek.

Request

POST
/openapi/v1/print/analyze
# Analyze an existing task
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or analyze a model URL directly
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb"
  }'

# Also check wall thickness for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

Parametry

  • Name
    input_task_id
    Type
    string
    Povinné
    Description

    Povinné, pokud neodešlete model_url. ID úlohy, jejíž model chcete analyzovat. Úloha musí mít stav SUCCEEDED a musí být vaše, nebo musí patřit do pracovního prostoru, jehož jste členem.

    Může se jednat o jeden z těchto typů úloh, pomocí Meshy 6 nebo novější, včetně Meshy 7:

    Funguje i úloha Opravit tisknutelnost.

  • Name
    model_url
    Type
    string
    Povinné
    Description

    Povinné, pokud neodešlete input_task_id. Model k analýze, jako veřejná URL adresa nebo Data URI. Pokud odešlete obojí, Meshy použije input_task_id.

    Z http nebo https URL adresy musí být model souborem .glb, .gltf, .obj, .fbx nebo .stl o velikosti nejvýše 400 MB. Data URI může obsahovat pouze soubor ve formátu base64 GLB (data:model/gltf-binary;base64,...) nebo glTF (data:model/gltf+json;base64,...) o velikosti nejvýše 100 MB. Soubor .obj, .fbx nebo .stl odešlete jako http nebo https URL adresu.

    Soubor větší než 100 MB musí navíc splňovat tato pravidla:

    • Soubor GLB, glTF, FBX nebo OBJ může mít nejvýše 10 000 000 ploch. Meshy počítá plochy jako trojúhelníky, takže čtyřúhelník se počítá jako 2 a síť vykreslená vícekrát se počítá jednou za každou kopii.
    • Soubor FBX musí být binární FBX verze 7.1 nebo novější.
    • Soubor GLB nebo glTF nesmí používat kompresi Draco.

    URL adresa ke stažení z Meshy (assets.meshy.ai/…?Expires=…&Signature=…) je podepsaná a přestane fungovat v okamžiku expires_at dané úlohy. Opětovné načtení úlohy ji neobnoví. U modelu, který jste vytvořili v Meshy, odešlete místo toho input_task_id, což funguje po dobu, kdy Meshy uchovává zdrojovou úlohu (viz Uchování assetů). Chcete-li model použít i po uplynutí této doby, stáhněte si ho před expires_at a odešlete vlastní kopii.

Chcete-li také zkontrolovat tloušťku stěny při velikosti, ve které plánujete tisknout, odešlete printer_type, velikost tisku, nebo obojí. Výsledek se nachází v printability.thin_walls. Kontrola tloušťky stěny trvá déle, takže úloha obvykle není připravena ihned, i když Meshy model už dříve analyzovalo.

  • Name
    printer_type
    Type
    string
    Description

    Tiskárna, kterou plánujete použít. Nastavuje minimální tloušťku stěny pro kontrolu tloušťky stěny. Pokud odešlete velikost tisku bez printer_type, Meshy použije fdm.

    Dostupné hodnoty:

    • fdm: filament, minimální tloušťka stěny 1,0 mm
    • sla: pryskyřice, minimální tloušťka stěny 0,8 mm
    • full_color: plnobarevný tisk, minimální tloušťka stěny 2,0 mm

    Jakákoli jiná hodnota vrátí 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    Výška tisku v milimetrech, od 1 do 1000. Hodnota mimo tento rozsah vrátí 400. Odešlete buď toto, nebo intended_print_longest_side_mm, ne obojí.

    Funguje pouze se vstupem ve formátu GLB. Pro model_url, který není soubor .glb, odešlete místo toho intended_print_longest_side_mm.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    Délka nejdelší strany tisku v milimetrech, od 1 do 1000. Hodnota mimo tento rozsah vrátí 400. Funguje s každým vstupním formátem.

Pokud odešlete printer_type bez velikosti, Meshy použije tuto velikost tisku:

  • soubor .glb nebo jakýkoli input_task_id: výška 150 mm
  • soubor .stl: vlastní nejdelší strana souboru, čtená jako milimetry
  • soubor .obj, .fbx nebo .gltf: 150 mm na nejdelší straně

Pro soubor STL v jiných jednotkách odešlete intended_print_longest_side_mm.

Meshy zaokrouhluje obě velikosti tisku na nejbližší milimetr.

Návratové hodnoty

Pole result v odpovědi obsahuje ID nové úlohy Analyzovat tisknutelnost.

Režimy selhání

  • Name
    400 - Bad Request
    Description

    Požadavek nelze spustit. Chybová zpráva uvádí, jaký problém byl zjištěn. Například:

    • Chybějící parametr: Nebyl odeslán ani input_task_id, ani model_url.
    • Neplatné UUID: input_task_id není platné UUID.
    • Neplatná URL adresa modelu: model_url je chybně formátované, používá nepodporované schéma nebo má nepodporovanou příponu souboru.
    • Soubor modelu je příliš velký: Soubor model_url je větší než 400 MB z http nebo https URL adresy, nebo větší než 100 MB jako Data URI.
    • Příliš mnoho ploch: Soubor model_url je soubor GLB, glTF, FBX nebo OBJ větší než 100 MB s více než 10 000 000 plochami. Snižte počet ploch a soubor odešlete znovu.
    • ASCII FBX přes 100 MB: Soubor model_url je ASCII FBX větší než 100 MB. Odešlete jej jako binární FBX nebo GLB.
    • Nečitelný soubor modelu: Soubor model_url je větší než 100 MB a Meshy nemůže přečíst jeho hlavičku. Jde například o GLB nebo glTF komprimovaný pomocí Draco, nebo binární FBX starší než 7.1.
    • Hlavička modelu je příliš složitá: Soubor model_url je větší než 100 MB a jeho hlavička obsahuje příliš mnoho sítí, uzlů nebo záznamů ke kontrole. Snižte počet objektů v souboru a odešlete jej znovu.
    • Soubor modelu nelze stáhnout: model_url vrátila chybu, nejčastěji proto, že platnost podepsané URL adresy ke stažení z Meshy vypršela. Opětovné načtení úlohy vrátí stejnou URL adresu se stejnou dobou platnosti. Odešlete vlastní kopii souboru, nebo odešlete input_task_id, dokud Meshy uchovává zdrojovou úlohu.
    • Úloha není dokončena: Úloha input_task_id je stále čekající, probíhá, nebo selhala.
    • Neplatná velikost tisku: intended_print_height_mm nebo intended_print_longest_side_mm je mimo rozsah 1 až 1000, nebo požadavek obsahuje obojí.
    • Neznámý typ tiskárny: printer_type není fdm, sla ani full_color.
    • Výška u modelu, který není ve formátu GLB: Požadavek obsahuje intended_print_height_mm a model_url, který není soubor .glb. Odešlete místo toho intended_print_longest_side_mm.
    • Tento model nelze podle výšky velikostně určit: Při požadované výšce, nebo výchozí hodnotě 150 mm, by nejdelší strana modelu byla mimo rozsah 1 až 1 000 mm. Nastává to i tehdy, je-li model plochý, nebo když Meshy nedokáže určit jeho velikost. Odešlete místo toho intended_print_longest_side_mm. U model_url ve formátu .glb a u některých úloh input_task_id to Meshy zjistí až po zahájení úlohy a úloha pak skončí jako FAILED.
    • Velikost STL nepoužitelná: Požadavek obsahuje printer_type bez velikosti a Meshy nemůže přečíst vlastní nejdelší stranu souboru .stl, nebo je mimo rozsah 1 až 1 000 mm. Odešlete intended_print_longest_side_mm.

    Opravte požadavek a odešlete jej znovu. Viz Chyby.

  • Name
    401 - Unauthorized
    Description

    API klíč chybí nebo je neplatný. Zkontrolujte hlavičku Authorization.

  • Name
    403 - Forbidden
    Description

    input_task_id je model typu basreliéf, který tento koncový bod nedokáže analyzovat. Zpráva zní This model type does not support this operation. Odešlete jiný model.

  • Name
    404 - Not Found
    Description

    Meshy nemůže najít model k analýze pro input_task_id. Například:

    • Úloha neexistuje, byla smazána, nebo není vaše ani nepatří do pracovního prostoru, jehož jste členem.
    • Úloha používá model starší než Meshy 6, nebo její typ nevytváří 3D model.
    • Soubor modelu úlohy už není uložen.

    Zkontrolujte, že input_task_id je podporovaná úloha, která je vaše nebo patří do jednoho z vašich pracovních prostorů, nebo odešlete model jako model_url.

  • Name
    429 - Too Many Requests
    Description

    Překročili jste svůj limit rychlosti, nebo máte příliš mnoho čekajících úloh. Počkejte a zkuste to znovu. Viz Limity rychlosti.


GET/openapi/v1/print/analyze/:id

Získání úlohy Analyzovat tisknutelnost

Vrátí úlohu Analyzovat tisknutelnost podle jejího ID.

Request

GET
/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}

Parametry

  • Name
    id
    Type
    path
    Description

    ID úlohy z odpovědi na její vytvoření.

Návratová hodnota

Objekt úlohy Analyzovat tisknutelnost. Jeho pole printability se objeví, až když je úloha SUCCEEDED. Pokud Meshy kontrolovalo tloušťku stěny, printability obsahuje také intended_print a thin_walls.


DELETE/openapi/v1/print/analyze/:id

Smazání úlohy Analyzovat tisknutelnost

Trvale smaže úlohu Analyzovat tisknutelnost, včetně jejího uloženého výsledku v mezipaměti. Smazání nelze vrátit zpět.

Request

DELETE
/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

Parametry cesty

  • Name
    id
    Type
    path
    Description

    ID úlohy, která se má smazat.

Stav úlohy

Smazání úlohy ve stavu PENDING vrátí kredity, které byly použity při jejím vytvoření.

Úlohu ve stavu IN_PROGRESS nelze smazat. Požadavek vrátí 409 Conflict, a úloha dál běží. Meshy nevrací kredity za úlohu, která už byla spuštěna, takže jejím smazáním byste přišli jak o kredity, tak o výsledek. Počkejte, až dosáhne stavu SUCCEEDED, FAILED nebo CANCELED, a pak ji smažte.

Smazání úlohy v konečném stavu (SUCCEEDED, FAILED nebo CANCELED) kredity nevrací.

Návratové hodnoty

200 OK, když je úloha smazána, nebo 409 Conflict, pokud je úloha ve stavu IN_PROGRESS.


GET/openapi/v1/print/analyze

Seznam úloh Analyzovat tisknutelnost

Vrátí seznam vašich úloh Analyzovat tisknutelnost.

Request

GET
/openapi/v1/print/analyze
curl https://api.meshy.ai/openapi/v1/print/analyze?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-analyze",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "expires_at": 1715725401000,
    "task_error": null,
    "printability": {
      "_version": "v1",
      "status": "warning",
      "issue_count": 1,
      "error_count": 0,
      "warning_count": 1,
      "metrics": {
        "is_watertight": true,
        "volume": 1.316167354292668,
        "non_manifold_edges": 0,
        "degenerate_faces": 43242,
        "holes": 0
      },
      "evaluated_at": 1700000001000
    },
    "consumed_credits": 0
  }
]

Parametry

  • Name
    page_num
    Type
    integer
    výchozí 1
    Description

    Číslo stránky, kterou chcete vrátit, počínaje 1.

  • Name
    page_size
    Type
    integer
    výchozí 10
    Description

    Počet úloh na stránku, maximálně 100.

  • Name
    sort_by
    Type
    string
    Description

    Pořadí řazení.

    Dostupné hodnoty:

    • +created_at: od nejstarších
    • -created_at: od nejnovějších

Návratové hodnoty

Stránkovaný seznam objektů úlohy Analyzovat tisknutelnost.


GET/openapi/v1/print/analyze/:id/stream

Streamovat úlohu Analyzovat tisknutelnost

Streamuje aktualizace úlohy Analyzovat tisknutelnost jako Server-Sent Events (SSE).

Request

GET
/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream
curl -N https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
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 abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

Parametry

  • Name
    id
    Type
    path
    Description

    ID úlohy z odpovědi při vytvoření.

Návratové hodnoty

Proud objektů úlohy Analyzovat tisknutelnost jako Server-Sent Events.

Každá událost obsahuje celý objekt úlohy ve stejném tvaru, jaký vrací koncový bod Get. Dokud je úloha ve stavu PENDING nebo IN_PROGRESS, jsou její výstupní pole prázdná (null, [] nebo {}) a finished_at má hodnotu 0. Meshy odesílá pole printability až poté, co má úloha stav SUCCEEDED.


Objekt úlohy Analyze Printability

Objekt úlohy Analyze Printability popisuje jednu analýzu 3D modelu. Obsahuje stav, progress a výsledek tisknutelnosti, pokud úloha uspěje.

The Analyze Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

The Analyze Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}
  • Name
    id
    Type
    string
    Description

    ID úlohy. Považujte ho za neprůhledný řetězec a nespoléhejte na jeho formát.

  • Name
    type
    Type
    string
    Description

    Typ úlohy, vždy print-analyze.

  • Name
    status
    Type
    string
    Description

    Stav úlohy, jedna z hodnot PENDING, IN_PROGRESS, SUCCEEDED, FAILED nebo CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Jak velká část úlohy je hotová, v procentech. Je 0, dokud úloha nezačne, a 100, když uspěje.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Počet úloh před touto úlohou ve frontě. Hodnota má smysl pouze během stavu PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

    Čas vytvoření úlohy, v milisekundách Unixového času.

  • Name
    started_at
    Type
    timestamp
    Description

    Čas zahájení úlohy, v milisekundách Unixového času. Je 0, dokud úloha nezačne.

  • Name
    finished_at
    Type
    timestamp
    Description

    Čas dokončení úlohy, v milisekundách Unixového času. Je 0, dokud úloha neskončí.

  • Name
    expires_at
    Type
    timestamp
    Description

    Čas, kdy vyprší platnost výsledku úlohy, v milisekundách Unixového času. Je 0, dokud úloha neskončí.

  • Name
    task_error
    Type
    object
    Description

    Podrobnosti chyby, pokud úloha selže. Je null, pokud úloha neselhala. Viz Chyby.

    • Name
      message
      Type
      string
      Description

      Popis toho, co se pokazilo.

  • Name
    printability
    Type
    object
    Description

    Výsledek analýzy. Není přítomen, dokud úloha nemá stav SUCCEEDED.

    • Name
      _version
      Type
      string
      Description

      Verze schématu výsledku tisknutelnosti. Hodnota je v1.

    • Name
      status
      Type
      string
      Description

      Celkové hodnocení, jedno z:

      • healthy: žádné chyby ani varování
      • warning: alespoň jedno varování a žádné chyby
      • error: alespoň jedna chyba
      • unknown: Meshy nedokázalo model analyzovat

      Pokud Meshy zkontrolovalo tloušťku stěny, jedná se o horší z výsledků kontrol sítě a thin_walls.status. Od nejhoršího k nejlepšímu je pořadí error, warning, unknown a healthy.

    • Name
      issue_count
      Type
      integer
      Description

      Celkový počet problémů, rovný error_count + warning_count.

    • Name
      error_count
      Type
      integer
      Description

      Počet problémů na úrovni chyby. Meshy počítá jednu chybu za každou z těchto situací:

      • Model není vodotěsný a má více než 8 děr.
      • Model má více než 8 děr.
      • Objem je nulový nebo nižší.
      • Model má více než 50 non-manifold hran.

      Pokud Meshy zkontrolovalo tloušťku stěny, stěny, které jsou příliš tenké (thin_walls.status je error), se počítají jako další chyba navíc.

    • Name
      warning_count
      Type
      integer
      Description

      Počet problémů na úrovni varování. Meshy počítá jedno varování za každou z těchto situací:

      • Model není vodotěsný a má 8 nebo méně děr.
      • Model má 1 až 8 děr.
      • Model má 1 až 50 non-manifold hran.
      • Model obsahuje degenerované plochy.
    • Name
      metrics
      Type
      object
      Description

      Surová geometrická měření modelu.

      • Name
        is_watertight
        Type
        boolean
        Description

        true, pokud síť nemá žádné okrajové hrany, tedy pokud je uzavřená.

      • Name
        volume
        Type
        number
        Description

        Objem modelu, v krychlových metrech.

      • Name
        non_manifold_edges
        Type
        integer
        Description

        Počet non-manifold hran.

      • Name
        degenerate_faces
        Type
        integer
        Description

        Počet degenerovaných ploch, tedy ploch s nulovou plochou nebo neplatných ploch.

      • Name
        holes
        Type
        integer
        Description

        Počet děr v síti, počítaných jako okrajové smyčky.

    • Name
      intended_print
      Type
      object
      Description

      Tiskárna a velikost, které kontrola tloušťky stěny použila. Přítomno pouze tehdy, pokud Meshy zkontrolovalo tloušťku stěny.

      • Name
        printer_type
        Type
        string
        Description

        Typ tiskárny, fdm, sla nebo full_color.

      • Name
        height_mm
        Type
        number
        Description

        Výška tisku v milimetrech, pokud je velikost tisku určena výškou. Jinak je null.

      • Name
        longest_side_mm
        Type
        number
        Description

        Délka nejdelší strany tisku, v milimetrech. Pokud je velikost tisku určena výškou, Meshy ji vypočítá z proporcí modelu.

      • Name
        wall_thickness_mm
        Type
        number
        Description

        Minimální tloušťka stěny pro printer_type, v milimetrech. Meshy nahlásí tenčí stěny jako příliš tenké.

      • Name
        dimensions_mm
        Type
        array
        Description

        Rozměry tisku [šířka, hloubka, výška], v milimetrech. Výška se může od height_mm lišit o zlomek milimetru. Je null pro vstup jiný než GLB, nebo pokud Meshy nedokáže určit velikost modelu.

    • Name
      thin_walls
      Type
      object
      Description

      Výsledek kontroly tloušťky stěny. Přítomno pouze tehdy, pokud Meshy zkontrolovalo tloušťku stěny.

      • Name
        thin_area_ratio
        Type
        number
        Description

        Podíl povrchu tenčího než intended_print.wall_thickness_mm, od 0 do 1. Je null, pokud Meshy nedokázalo model změřit.

      • Name
        has_thin_walls
        Type
        boolean
        Description

        true, pokud je jakákoli část povrchu příliš tenká. Samotné ostré rohy mohou tuto hodnotu nastavit na true, proto použijte status k rozhodnutí, zda je potřeba stěny zesílit. Je null, pokud Meshy nedokázalo model změřit.

      • Name
        status
        Type
        string
        Description

        Hodnocení tloušťky stěny, jedno z:

        • healthy: 5 % nebo méně povrchu je příliš tenkých.
        • error: více než 5 % povrchu je příliš tenkých. Pro zesílení stěn odešlete id této úlohy do Opravit tisknutelnost jako input_task_id. Pokud tato úloha analyzovala soubor .stl, .fbx nebo .gltf z model_url, odešlete místo toho tento soubor jako model_url.
        • unknown: Meshy nedokázalo model změřit. Pokud samotná kontrola tloušťky stěny selže, úloha skončí jako FAILED.
    • Name
      evaluated_at
      Type
      timestamp
      Description

      Čas, kdy Meshy vypočítalo analýzu, v milisekundách Unixového času.

  • Name
    consumed_credits
    Type
    integer
    Description

    Počet kreditů, které úloha spotřebovala. Vždy je 0, protože analýza je zdarma.