Auto Split API

De ID van de taak waarvan het model gesplitst moet worden. De taak moet de status SUCCEEDED hebben. Deze taaktypen werken:

• Afbeelding naar 3D
• Multi-afbeelding naar 3D
• Tekst naar 3D, een preview- of refine-taak
• Hertextureren
• Remesh
• Converteren
• Formaat wijzigen

Het model moet gegenereerd zijn met Meshy 6 of Meshy 7, dat wil zeggen met ai_model ingesteld op meshy-6-lite, meshy-6, meshy-7, meshy-7.1, of latest. Smart Topology-modellen (meshy-t2 en meshy-t2.5) worden niet ondersteund. Voor een refine-, Hertextureren-, Remesh-, Converteren- of Formaat wijzigen-taak geldt de regel voor het model waarmee de taak begon. Een Hertextureren-, Remesh-, Converteren- of Formaat wijzigen-taak gemaakt van een geüpload model geeft 400 terug.

Het model mag maximaal 8.000.000 vlakken bevatten. Een model met meer vlakken geeft 400 terug. Voer in dat geval eerst een Remesh-taak erop uit, en stuur de ID van de Remesh-taak in plaats daarvan.

Je kunt een getextureerd model splitsen. Om de textuur op de delen te behouden, stuur je keep_texture: true.

Hoe het model in delen wordt verdeeld.

Beschikbare waarden:

• auto: Meshy kiest de sneden en negeert prompt. Een prompt van meer dan 600 tekens geeft nog steeds 400 terug.
• by_parts: Meshy snijdt langs de structurele delen die je noemt in prompt, bijvoorbeeld hoofd, armen en romp.
• by_color: Meshy snijdt langs de kleurgebieden die je noemt in prompt. Meshy vindt de gebieden in de bronafbeelding, niet in de textuur van het invoermodel. De invoer moet gegenereerd zijn vanuit een geüploade afbeelding, met Afbeelding naar 3D of Multi-afbeelding naar 3D. Andere invoer geeft 400 terug. Voor Multi-afbeelding naar 3D gebruikt Meshy de eerste bronafbeelding.

De bestandsformaten die gegenereerd worden. Meshy genereert altijd glb en geeft dit terug in model_urls, plus de overige formaten die je opgeeft.

Beschikbare waarden:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Elk formaat behalve stl ondersteunt scène-objecten en bewaart elk deel als een apart object. Een STL-bestand kan geen aparte objecten bevatten, dus Meshy voegt de delen samen tot één geheel, geordend volgens layout. Om delen te krijgen die je apart kunt selecteren in een slicer, vraag je 3mf aan.

Met keep_texture: true bevatten deze formaten de textuur:

• glb, fbx, usdz, en blend: De textuur zit in het bestand.
• obj: De textuur zit in het materiaalbestand, dat model_urls teruggeeft onder mtl.
• stl en 3mf: Het bestand bevat alleen geometrie, zonder de textuur.

Hoe Meshy de delen ordent, in elk bestandsformaat en in de thumbnail.

Beschikbare waarden:

• assembled: Meshy houdt de delen op hun plaats zoals in het bronmodel.
• on_plate: Meshy legt de delen plat neer en spreidt ze uit op het printbed, klaar om te slicen. Dit is dezelfde indeling als de On Plate-weergave in de web-app.

In beide indelingen verwijdert Meshy voor export elk ingeklapt flintertje of puntvormig stukje dat een snede achterlaat, zodat elk deel dat je krijgt printbaar is. Formaten die scène-objecten ondersteunen bevatten één object per deel, en stl voegt de delen samen tot één geheel.

Of de textuur van het invoermodel behouden moet blijven op de delen. true geeft elk deel de textuur van de invoer, en de taak geeft de maps terug in texture_urls. false geeft elk deel een vlakke vertexkleur.

Met true duurt de taak ongeveer twee keer zo lang, en de credit-kosten veranderen niet. Een ongetextureerde invoer wordt op dezelfde manier gesplitst als met false. Als Meshy de textuur niet kan behouden, mislukt de taak met de foutcode textured_split_refused. Zie Fouten.

Of er pen-en-gatverbindingen (mortise-and-tenon) bij elke snede toegevoegd moeten worden, zodat de geprinte delen in elkaar passen.

Het verzoek kan niet worden uitgevoerd. Het foutbericht vermeldt welk probleem is gevonden. Bijvoorbeeld:

• Ontbrekende prompt: mode is by_parts of by_color, en prompt ontbreekt.
• Prompt beschrijft geen splitsing, of te veel delen: De prompt vraagt om het model in één stuk te houden, of noemt meer dan 10 delen. by_parts en by_color accepteren 1 tot 10 benoemde delen. Meshy rekent hier niets voor.
• Niet-ondersteunde invoertaak: input_task_id is geen geslaagde taak van een ondersteund type, gegenereerd met Meshy 6 of Meshy 7.
• Geen referentieafbeelding: mode is by_color, en de invoer is niet gegenereerd vanuit een geüploade afbeelding.
• Verbinding buiten bereik: connector_size of connector_height valt buiten 0.1 tot 0.8.

Herstel het verzoek en stuur het opnieuw. Zie Fouten.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Bijvoorbeeld:

• Onvoldoende credits: Het account heeft niet genoeg credits voor deze taak, of het account heeft een creditlimiet bereikt. Controleer je creditsaldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade je abonnement in je abonnementsinstellingen en probeer het opnieuw.

Een van de volgende situaties is van toepassing:

• Contentmoderatie heeft de prompt geblokkeerd. Het bericht is explicit content of prohibited content. Pas de prompt aan en probeer het opnieuw.
• input_task_id is een bas-reliëfmodel, dat dit endpoint niet kan splitsen. Het bericht is This model type does not support this operation. Stuur een ander model.

input_task_id bestaat niet of behoort niet tot jouw account. Controleer de ID en gebruik een API-sleutel van het account dat de taak heeft aangemaakt.

Je hebt je rate limit overschreden. Wacht en probeer het opnieuw. Zie Rate limits.

by_parts- en by_color-verzoeken delen ook een prompt-leeslimiet van 12 verzoeken per minuut per account.

Splitsen op basis van prompt (by_parts en by_color) is tijdelijk niet beschikbaar. Probeer het later opnieuw, of stuur mode: "auto", wat nog steeds werkt. Meshy rekent hier niets voor.

De taak-ID uit de aanmaakrespons.

De ID van de te verwijderen taak.

Het paginanummer dat moet worden geretourneerd. Begint bij en standaard 1.

Het aantal taken per pagina, tot 100. Standaard 10. Meshy behandelt een grotere waarde als 100.

De sorteervolgorde.

Beschikbare waarden:

• +created_at: oudste eerst
• -created_at: nieuwste eerst

De taak-ID uit de aanmaakrespons.

De taak-ID. Behandel deze als een ondoorzichtige string en vertrouw niet op het formaat ervan.

Het taaktype, altijd print-split.

Downloadlinks voor het gesplitste model, één per aangevraagd formaat. Een niet-aangevraagd formaat heeft geen sleutel. Formaten die scèneobjecten ondersteunen houden elk onderdeel als een apart object, en stl versmelt de onderdelen tot één massief geheel.

Downloadlink voor een voorbeeldafbeelding van het gesplitste model, in de aangevraagde layout. Wanneer de onderdelen een textuur behouden, toont het voorbeeld deze. Anders heeft elk onderdeel zijn eigen kleur.

De textuurmaps van het gesplitste model, als een array met één object. Alle onderdelen delen deze maps. Alleen aanwezig wanneer keep_texture true is en het invoermodel een textuur heeft.

Downloadlink voor een versie van thumbnail_url met een transparante achtergrond (RGBA). Alleen aanwezig nadat de taak is geslaagd, wanneer Meshy de transparante preview heeft gerenderd.

Of Meshy de prompt heeft genegeerd. Dit is true wanneer de prompt van een by_parts- of by_color-aanvraag geen onderdelen benoemde, waardoor Meshy het model automatisch heeft gesplitst. De onderdeelnamen in het resultaat zijn dan van Meshy, niet van u. Aanwezig vanaf PENDING. Meshy laat dit veld weg voor auto-taken en telkens wanneer de prompt is gevolgd.

Het aantal printbare onderdelen dat de splitsing heeft opgeleverd. Formaten die scèneobjecten ondersteunen bevatten één object per onderdeel. stl versmelt de onderdelen tot één massief geheel, maar part_count telt ze nog steeds. Vóór het exporteren verwijdert Meshy ingeklapte splinters die geen printbaar onderdeel kunnen worden, en telt deze niet mee.

Hoeveel van de taak is voltooid, als percentage. Dit is 0 totdat de taak start en 100 wanneer deze slaagt.

De taakstatus, een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED of CANCELED.

Het aantal taken dat vóór deze taak in de wachtrij staat. De waarde is alleen betekenisvol terwijl de taak PENDING is.

Tijdstip waarop de taak is aangemaakt, in Unix-milliseconden.

Tijdstip waarop de taak is gestart, in Unix-milliseconden. Dit is 0 totdat de taak start.

Tijdstip waarop de taak is beëindigd, in Unix-milliseconden. Dit is 0 totdat de taak wordt beëindigd.

Tijdstip waarop het resultaat van de taak verloopt, in Unix-milliseconden. Dit is 0 totdat de taak wordt beëindigd.

De foutdetails wanneer de taak mislukt. Zie Fouten.

Als een veiligheidscontrole het invoermodel afwijst, mislukt de taak met task_error.type ingesteld op invalid_input en task_error.code ingesteld op provider_content_refused. Stuur een ander model. Zie Fouten.

Met keep_texture: true mislukt de taak, als Meshy de textuur niet kan behouden, met task_error.code ingesteld op textured_split_refused. Zie Fouten.

Het aantal credits dat de taak heeft gebruikt. Dit is altijd aanwezig. Het is 10 nadat Meshy de taak heeft geaccepteerd, en 0 voor een FAILED-taak, omdat Meshy de credits terugbetaalt wanneer een taak mislukt. Het verwijderen van een PENDING-taak betaalt deze ook terug.