Auto Split API

Het ID van een geslaagde taak waarvan het model gesplitst moet worden. Ondersteunde taaktypes: 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 gegenereerd zijn 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 delen wordt opgesplitst.

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 input die gegenereerd is vanuit een geüploade afbeelding (Afbeelding naar 3D of Multi-afbeelding naar 3D); andere inputs worden afgewezen met 400.

Formaten waarin het gesplitste model geëxporteerd wordt. 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.

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 printbed, klaar om te slicen — dezelfde indeling als de On Plate-weergave in de web-app.

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

Voegt pen-en-gat-connectoren 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 benoemt minder dan twee onderdelen: by_parts / by_color vereist ten minste twee benoemde stukken (bijvoorbeeld head, torso, base); een algemene instructie zoals split into individual parts wordt afgewezen. Er wordt niets in rekening gebracht.
• Niet-ondersteunde inputtaak: input_task_id moet verwijzen naar een geslaagde taak van een ondersteund type, gegenereerd met Meshy 6 of Meshy 7.
• Getextureerde input: Het inputmodel heeft textures. Voorlopig worden alleen modellen zonder textures ondersteund.
• Geen referentieafbeelding: by_color vereist een input die gegenereerd is vanuit een geüploade afbeelding.
• Niet-ondersteund formaat: target_formats bevat stl.
• 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.

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 voor promptverwerking van 12 verzoeken per minuut per account.

Op prompts gebaseerde splitsing (by_parts en by_color) is tijdelijk niet beschikbaar. Probeer het later opnieuw, of gebruik mode: "auto", die hier niet door beïnvloed wordt. 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 identificatie voor de taak. Hoewel we als implementatiedetail een k-sorteerbare UUID gebruiken voor taak-id's, mag je geen aannames doen over het formaat 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 voorbeeldweergave 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-verzoek geen onderdelen benoemde, waardoor Meshy het model in plaats daarvan automatisch heeft gesplitst — de onderdeelnamen in het resultaat zijn van Meshy, niet van jou. Aanwezig vanaf PENDING. Weggelaten bij auto-taken en telkens wanneer de prompt is gevolgd.

Aantal printbare onderdelen in het gesplitste model — één per object in de geëxporteerde bestanden. Ingezakte flinters 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 voorafgaande taken.

Tijdstempel van het moment waarop de taak is aangemaakt, in milliseconden.

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

Tijdstempel van het moment waarop 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 falen worden terugbetaald. Het verwijderen van een taak terwijl deze nog PENDING is, betaalt de kosten eveneens terug.