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, meshy-t2.5) worden niet ondersteund. Een getextureerd model wordt geaccepteerd, maar de textuur ervan wordt niet overgenomen in het resultaat.

Hoe het model wordt opgedeeld in onderdelen.

Beschikbare waarden:

• auto: Meshy kiest de sneden. 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 vanuit 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èneobjecten ondersteunen (glb, obj, fbx, usdz, blend, 3mf) bevatten elk onderdeel als een apart object; stl kent geen aparte objecten, dus daarin worden alle onderdelen samengevoegd tot één geheel geheel, gerangschikt volgens layout (vraag 3mf aan voor afzonderlijk selecteerbare onderdelen in een slicer). glb wordt altijd gegenereerd en geretourneerd in model_urls; vermeld eventuele andere gewenste formaten extra.

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

Hoe de onderdelen worden gerangschikt in elk uitvoerformaat, en in de thumbnail.

Beschikbare waarden:

• assembled: Onderdelen blijven waar het bronmodel ze had.
• on_plate: Onderdelen worden plat neergelegd en verspreid op het bouwplatform, klaar om te slicen — dezelfde indeling als de On Plate-weergave van de web-app.

In beide indelingen wordt een ingeklapt flintertje of puntvormig restant van een snede vóór export verwijderd, zodat elk onderdeel dat je krijgt printbaar is. Formaten die scèneobjecten ondersteunen, bevatten één object per onderdeel; stl voegt ze samen tot één geheel.

Voegt pen-en-gatverbindingen toe bij elke snede, zodat de geprinte onderdelen in elkaar passen.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ontbrekende prompt: prompt is verplicht wanneer mode by_parts of by_color is.
• Prompt beschrijft geen splitsing, of te veel onderdelen: by_parts / by_color accepteert 1 tot 10 benoemde onderdelen. Een beschrijving die vraagt om het model in één stuk te houden, of meer dan 10 onderdelen noemt, wordt geweigerd. Er wordt niets in rekening gebracht.
• Niet-ondersteunde invoertaak: 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 vanuit een geüploade afbeelding.
• Connector 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 limiet van 12 verzoeken per minuut per account voor het verwerken van prompts.

Prompt-gebaseerd splitsen (by_parts en by_color) is tijdelijk niet beschikbaar. Probeer het later opnieuw, of gebruik mode: "auto", wat 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 standaard is 1.

Limiet voor paginagrootte. Standaard 10 items. Maximaal toegestaan is 100 items; hogere waarden worden beperkt tot 100.

Veld om op te sorteren. Beschikbare waarden:

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

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

Unieke identifier 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 onderdeel als een apart object; stl smelt ze samen tot één vast object. De eigenschap voor een formaat wordt weggelaten als dat formaat niet is aangevraagd.

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

true wanneer de prompt van een by_parts- of by_color-aanvraag geen onderdelen noemde, waardoor Meshy het model automatisch heeft gesplitst — de onderdeelnamen in het resultaat zijn die van Meshy, niet de jouwe. Aanwezig vanaf PENDING. Weggelaten voor auto-taken en wanneer de prompt wel is gevolgd.

Aantal printbare onderdelen dat de split heeft opgeleverd. Formaten die scène-objecten ondersteunen bevatten één object per onderdeel; stl smelt ze samen tot één vast object, en het aantal rapporteert nog steeds de onderdelen. Ingeklapte splinters die de segmentatie niet in een printbaar stuk kon omzetten, worden vóór de export uit de bestanden verwijderd en 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. Als de veiligheidscontrole van de modelaanbieder het invoermodel weigert, mislukt de taak met task_error.type invalid_input en code provider_content_refused. Zie Fouten.

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 een mislukking worden terugbetaald. Het verwijderen van een taak terwijl deze nog PENDING is, resulteert eveneens in terugbetaling.