Auto Split API

De ID van een geslaagde taak waarvan het model gesplitst moet worden. Ondersteunde taaktypen: Afbeelding naar 3D, Multi-afbeelding naar 3D, Tekst naar 3D (preview), Remesh, Converteren, en Formaat wijzigen. De taak moet de status SUCCEEDED hebben, en het model moet zijn gegenereerd met Meshy 6 of Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1, of latest). Low-poly- en Smart Topology-modellen (meshy-t2) worden niet ondersteund. Een model met textuur wordt geaccepteerd, maar de textuur wordt niet meegenomen in het resultaat.

Hoe het model in delen wordt verdeeld.

Beschikbare waarden:

• auto: Meshy bepaalt de sneden zelf. prompt wordt genegeerd.
• by_parts: Snijd langs de structurele onderdelen die je noemt in prompt, zoals hoofd, armen en romp.
• by_color: Snijd langs de kleurgebieden die je noemt in prompt. Vereist een invoer die is gegenereerd uit een geüploade afbeelding (Afbeelding naar 3D of Multi-afbeelding naar 3D); andere invoer wordt geweigerd met 400. De grenzen van de kleurgebieden komen uit de bronafbeelding, niet uit de textuur van het invoermodel. Voor Multi-afbeelding naar 3D gebruikt Auto Split de eerste bronafbeelding.

Formaten waarin het gesplitste model wordt geëxporteerd. Formaten die scène-objecten ondersteunen (glb, obj, fbx, usdz, blend, 3mf) bevatten elk deel als een apart object; stl heeft geen begrip van afzonderlijke objecten, dus dat voegt elk deel samen tot één vast object, gerangschikt volgens layout (vraag 3mf aan voor afzonderlijk selecteerbare delen in een slicer). glb wordt altijd gegenereerd en geretourneerd in model_urls; vermeld eventuele andere gewenste formaten aanvullend.

Beschikbare waarden: glb, obj, fbx, stl, usdz, blend, 3mf.

Hoe de delen worden gerangschikt in elk uitvoerformaat en in de thumbnail.

Beschikbare waarden:

• assembled: Delen blijven op de plek waar ze in het bronmodel stonden.
• on_plate: Delen worden plat neergelegd en uitgespreid op het printbed, klaar om te slicen — dezelfde indeling als de On Plate-weergave van de web-app.

In beide indelingen wordt een ingeklapt flintertje of puntachtig restdeel dat overblijft van een snede vóór het exporteren verwijderd, zodat elk deel dat je krijgt printbaar is. Formaten die scène-objecten ondersteunen bevatten één object per deel; stl voegt ze samen tot één vast object.

Voegt pen-en-gatverbindingen (mortise-and-tenon) toe bij elke snede zodat de geprinte delen in elkaar passen.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende prompt: prompt is vereist wanneer mode gelijk is aan by_parts of by_color.
• Prompt beschrijft geen splitsing, of te veel delen: by_parts / by_color accepteert 1 tot 10 benoemde stukken. Een beschrijving die vraagt om het model in één stuk te houden, of meer dan 10 delen noemt, wordt geweigerd. Er wordt niets in rekening gebracht.
• Niet-ondersteunde invoertaak: De input_task_id moet verwijzen naar een geslaagde taak van een ondersteund type, gegenereerd met Meshy 6 of Meshy 7.
• Geen referentieafbeelding: by_color vereist een invoer die is gegenereerd uit een geüploade afbeelding.
• Verbinding buiten bereik: connector_size of connector_height valt buiten 0.1 tot 0.8.

Authenticatie is mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

De input_task_id bestaat niet of behoort niet tot jouw account.

Je hebt je rate limit overschreden. by_parts- en by_color-verzoeken delen ook een prompt-verwerkingslimiet van 12 verzoeken per minuut per account.

Prompt-gebaseerd splitsen (by_parts en by_color) is tijdelijk niet beschikbaar. Probeer het later opnieuw, of gebruik mode: "auto", die hier niet door wordt beïnvloed. Er wordt niets in rekening gebracht.

De ID van de Auto Split-taak die moet worden opgehaald.

De ID van de Auto Split-taak die moet worden verwijderd.

Paginanummer voor paginering. Begint bij en staat standaard op 1.

Maximaal aantal items per pagina. Standaard 10 items. Maximaal toegestaan is 100 items; hogere waarden worden afgekapt tot 100.

Veld waarop gesorteerd wordt. Beschikbare waarden:

• +created_at: Sorteren op aanmaaktijd in oplopende volgorde.
• -created_at: Sorteren op aanmaaktijd in aflopende volgorde.

Unieke identifier voor de Auto Split-taak die gestreamd moet worden.

Unieke identificatie voor de taak. Hoewel we als implementatiedetail een k-sorteerbare UUID gebruiken voor taak-id's, moet je geen aannames doen over de indeling van de id.

Type van de taak. De waarde is print-split.

Downloadbare URL's naar het gesplitste model, één per aangevraagd formaat. Formaten die scène-objecten ondersteunen houden elk deel als een apart object; stl voegt ze samen tot één massief object. De eigenschap voor een formaat wordt weggelaten als het formaat niet werd aangevraagd.

Downloadbare URL naar een gerenderde voorvertoning van het gesplitste model, met elk deel in een aparte kleur, in de aangevraagde layout.

true wanneer de prompt van een by_parts- of by_color-aanvraag geen delen benoemde, waardoor Meshy het model automatisch heeft gesplitst — de deelnamen in het resultaat zijn van Meshy, niet van jou. Aanwezig vanaf PENDING. Weggelaten voor auto-taken en telkens wanneer de prompt werd gevolgd.

Aantal printbare delen dat de splitsing heeft opgeleverd. Formaten die scène-objecten ondersteunen bevatten één object per deel; stl voegt ze samen tot één massief object, en het aantal geeft nog steeds de delen weer. Ingeklapte splinters die de segmentatie niet in een printbaar stuk kon omzetten, worden vóór het exporteren uit de bestanden verwijderd en worden niet meegeteld.

Voortgang van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

Status van de taak. Mogelijke waarden zijn PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Het aantal voorgaande taken.

Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

Tijdstempel van wanneer de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap 0.

Tijdstempel van wanneer de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, is deze eigenschap 0.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige referentie van het task_error-object.

Het aantal credits dat door deze taak is verbruikt. Altijd aanwezig: 10 zodra de taak is geaccepteerd, en 0 voor FAILED-taken omdat de kosten bij mislukking worden terugbetaald. Het verwijderen van een taak terwijl deze nog PENDING is, betaalt de kosten eveneens terug.