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, of latest). Low-poly- en Smart Topology-modellen (meshy-t2) worden niet ondersteund.

Hoe het model in onderdelen wordt verdeeld.

Beschikbare waarden:

• auto: Meshy bepaalt de sneden. prompt wordt genegeerd.
• by_parts: Snijdt langs de structurele onderdelen die je noemt in prompt, zoals hoofd, armen en romp.
• by_color: Snijdt langs de kleurgebieden die je noemt in prompt. Vereist een invoer die is gegenereerd op basis van een geüploade afbeelding (Afbeelding naar 3D of Multi-afbeelding naar 3D); andere invoer wordt afgewezen met 400.

Formaten waarin het gesplitste model wordt geëxporteerd. Elk onderdeel is een apart object in elk formaat. glb wordt altijd geproduceerd en geretourneerd in model_urls; vermeld eventuele andere gewenste formaten daarnaast.

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

3mf wordt geschreven voor slicers: één object per onderdeel, elk op een eigen filamentslot, zodat Bambu Studio het bestand opent als afzonderlijk gekleurde, apart selecteerbare onderdelen (het archief bevat een Bambu Studio-projectconfiguratie; andere slicers lezen de geometrie). Zoals bij de andere printformaten van Meshy is dit in millimeters en, omdat deze endpoint geen doelgrootte accepteert, wordt het hele model geschaald zodat de langste zijde 150 mm is — dezelfde limiet die de andere printformaat-exports gebruiken, gekozen om op elk gangbaar bouwplatform te passen. Met layout: "on_plate" geldt de limiet voor het uitgelegde plateau als geheel, zodat het bestand klaar is om te slicen; met assembled blijven de onderdelen op de plek waar het bronmodel ze had, en regel je de plaatsing zelf in de slicer.

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

Beschikbare waarden:

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

In beide indelingen bevatten de geëxporteerde bestanden precies één object per onderdeel en verder niets: een ingeklapt splintertje of puntachtig restant van een snede wordt vóór het exporteren verwijderd, zodat elk object dat je in het bestand aantreft printbaar is.

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

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende prompt: prompt is verplicht wanneer mode by_parts of by_color is.
• Prompt noemt minder dan twee onderdelen: by_parts / by_color heeft minstens twee benoemde stukken nodig (bijvoorbeeld head, torso, base); een algemene instructie zoals split into individual parts wordt afgewezen. 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.
• Invoer met textures: Het invoermodel heeft textures. Vooralsnog worden alleen modellen zonder textures ondersteund.
• Geen referentieafbeelding: by_color vereist een invoer die is gegenereerd op basis van een geüploade afbeelding.
• Niet-ondersteund formaat: target_formats bevat stl.
• Verbinding buiten bereik: connector_size of connector_height valt buiten 0.1 tot 0.8.

Authenticatie 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.

Op prompts 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 verwijderd moet worden.

Paginanummer voor paginering. Begint en heeft standaard de waarde 1.

Limiet voor paginagrootte. Standaard 10 items. Maximaal toegestaan is 100 items; hogere waarden worden begrensd op 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 gestreamd moet worden.

Unieke identifier voor de taak. Hoewel we als implementatiedetail een k-sorteerbare UUID voor taak-id's gebruiken, mag 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. Elk onderdeel is een apart object in het bestand. 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 bij een by_parts- of by_color-aanvraag de prompt geen onderdelen benoemde, waardoor Meshy het model automatisch heeft gesplitst — de onderdeelnamen in het resultaat zijn dan van Meshy, niet van jou. Aanwezig vanaf PENDING. Weggelaten voor auto-taken en wanneer de prompt wel is gevolgd.

Aantal printbare onderdelen in het gesplitste model — één per object in de geëxporteerde bestanden. Ingeklapte flinters die de segmentatie niet in een printbaar stuk kon omzetten, worden vóór het exporteren 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 voorafgaande 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 afgerond, in milliseconden. Als de taak nog niet is afgerond, 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 falen worden terugbetaald. Het verwijderen van een taak terwijl deze nog PENDING is, betaalt het bedrag ook terug.