Auto Split API

Die ID des Tasks, dessen Modell aufgeteilt werden soll. Der Task muss den Status SUCCEEDED haben. Diese Task-Typen funktionieren:

• Bild zu 3D
• Multi-Bild zu 3D
• Text zu 3D, ein preview- oder refine-Task
• Neutexturierung
• Neuvernetzung
• Konvertieren
• Größe ändern

Das Modell muss mit Meshy 6 oder Meshy 7 generiert worden sein, das heißt mit ai_model auf meshy-6-lite, meshy-6, meshy-7, meshy-7.1 oder latest gesetzt. Smart Topology-Modelle (meshy-t2 und meshy-t2.5) werden nicht unterstützt. Bei einem refine-, Neutexturierungs-, Neuvernetzungs-, Konvertierungs- oder Größenänderungs-Task gilt die Regel für das Modell, von dem der Task ausgegangen ist. Ein Neutexturierungs-, Neuvernetzungs-, Konvertierungs- oder Größenänderungs-Task, der aus einem hochgeladenen Modell erstellt wurde, gibt 400 zurück.

Das Modell darf höchstens 8.000.000 Flächen haben. Ein Modell mit mehr Flächen gibt 400 zurück. Führen Sie in diesem Fall zuerst einen Neuvernetzungs-Task dafür aus und senden Sie stattdessen die ID des Neuvernetzungs-Tasks.

Sie können ein texturiertes Modell aufteilen. Um die Textur auf den Teilen zu behalten, senden Sie keep_texture: true.

Wie das Modell in Teile aufgeteilt wird.

Verfügbare Werte:

• auto: Meshy wählt die Schnitte und ignoriert prompt. Ein prompt mit mehr als 600 Zeichen gibt weiterhin 400 zurück.
• by_parts: Meshy schneidet entlang der strukturellen Teile, die Sie in prompt benennen, zum Beispiel Kopf, Arme und Oberkörper.
• by_color: Meshy schneidet entlang der Farbbereiche, die Sie in prompt benennen. Meshy findet die Bereiche im Ausgangsbild, nicht in der Textur des Eingabemodells. Die Eingabe muss aus einem hochgeladenen Bild generiert worden sein, mit Bild zu 3D oder Multi-Bild zu 3D. Andere Eingaben geben 400 zurück. Bei Multi-Bild zu 3D verwendet Meshy das erste Ausgangsbild.

Die zu generierenden Dateiformate. Meshy generiert immer glb und gibt es in model_urls zurück, zuzüglich der weiteren von Ihnen aufgelisteten Formate.

Verfügbare Werte:

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

Jedes Format außer stl unterstützt Szeneobjekte und hält jedes Teil als separates Objekt. Eine STL-Datei kann keine separaten Objekte enthalten, daher verschmilzt Meshy die Teile zu einem einzigen Körper, angeordnet nach layout. Um Teile zu erhalten, die Sie in einem Slicer separat auswählen können, fordern Sie 3mf an.

Mit keep_texture: true enthalten diese Formate die Textur:

• glb, fbx, usdz und blend: Die Textur befindet sich in der Datei.
• obj: Die Textur befindet sich in der Materialdatei, die model_urls unter mtl zurückgibt.
• stl und 3mf: Die Datei enthält nur die Geometrie, ohne die Textur.

Wie Meshy die Teile anordnet, in jedem Dateiformat und in der Miniaturansicht.

Verfügbare Werte:

• assembled: Meshy behält die Teile dort, wo sie im Ausgangsmodell waren.
• on_plate: Meshy legt die Teile flach und verteilt sie auf der Druckplatte, bereit zum Slicen. Dies ist dieselbe Anordnung wie die On-Plate-Ansicht in der Web-App.

In beiden Layouts entfernt Meshy vor dem Export jedes eingefallene, splitterartige oder punktförmige Stück, das ein Schnitt hinterlässt, sodass jedes erhaltene Teil druckbar ist. Formate, die Szeneobjekte unterstützen, enthalten ein Objekt pro Teil, und stl verschmilzt die Teile zu einem einzigen Körper.

Ob die Textur des Eingabemodells auf den Teilen beibehalten werden soll. true gibt jedem Teil die Textur der Eingabe, und der Task gibt die Maps in texture_urls zurück. false gibt jedem Teil eine einfarbige Vertex-Farbe.

Mit true dauert der Task etwa doppelt so lange, und die Credit-Kosten ändern sich nicht. Eine untexturierte Eingabe wird genauso aufgeteilt wie mit false. Wenn Meshy die Textur nicht beibehalten kann, schlägt der Task mit dem Fehlercode textured_split_refused fehl. Siehe Fehler.

Ob an jedem Schnitt Zapfen-Zinken-Verbinder hinzugefügt werden sollen, damit die gedruckten Teile zusammenpassen.

Die Anfrage kann nicht ausgeführt werden. Die Fehlermeldung gibt an, welches Problem gefunden wurde. Zum Beispiel:

• Fehlender prompt: mode ist by_parts oder by_color, und prompt fehlt.
• Prompt beschreibt keine Aufteilung oder zu viele Teile: Der prompt verlangt, das Modell als ein Stück zu behalten, oder benennt mehr als 10 Teile. by_parts und by_color akzeptieren 1 bis 10 benannte Teile. Meshy berechnet die Anfrage nicht.
• Nicht unterstützter Eingabe-Task: input_task_id ist kein erfolgreicher Task eines unterstützten Typs, generiert mit Meshy 6 oder Meshy 7.
• Kein Referenzbild: mode ist by_color, und die Eingabe wurde nicht aus einem hochgeladenen Bild generiert.
• Verbinder außerhalb des Bereichs: connector_size oder connector_height liegt außerhalb von 0.1 bis 0.8.

Korrigieren Sie die Anfrage und senden Sie sie erneut. Siehe Fehler.

Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den Authorization-Header.

Zum Beispiel:

• Unzureichende Credits: Das Konto hat nicht genügend Credits für diesen Task, oder das Konto hat ein Credit-Limit erreicht. Überprüfen Sie Ihr Credit-Guthaben und versuchen Sie es erneut.
• Kostenloser Plan: Das Erstellen eines Tasks erfordert einen kostenpflichtigen Plan. Aktualisieren Sie Ihren Plan in Ihren Abonnement-Einstellungen und versuchen Sie es erneut.

Einer der folgenden Fälle liegt vor:

• Die Inhaltsmoderation hat den prompt blockiert. Die Meldung lautet explicit content oder prohibited content. Ändern Sie den prompt und versuchen Sie es erneut.
• input_task_id ist ein Flachrelief-Modell, das dieser Endpunkt nicht aufteilen kann. Die Meldung lautet This model type does not support this operation. Senden Sie ein anderes Modell.

input_task_id existiert nicht oder gehört nicht zu Ihrem Konto. Überprüfen Sie die ID und verwenden Sie einen API-Schlüssel des Kontos, das den Task erstellt hat.

Sie haben Ihre Ratenbegrenzung überschritten. Warten Sie und versuchen Sie es erneut. Siehe Ratenbegrenzungen.

by_parts- und by_color-Anfragen teilen sich zudem ein Limit für das Lesen von prompts von 12 Anfragen pro Minute pro Konto.

Das Aufteilen per prompt (by_parts und by_color) ist vorübergehend nicht verfügbar. Versuchen Sie es später erneut, oder senden Sie mode: "auto", was weiterhin funktioniert. Meshy berechnet die Anfrage nicht.

Die Task-ID aus der Antwort der Erstellung.

Die ID des zu löschenden Tasks.

Die zurückzugebende Seitenzahl. Beginnt bei und ist standardmäßig 1.

Die Anzahl der Aufgaben pro Seite, bis zu 100. Standardmäßig 10. Meshy behandelt einen größeren Wert als 100.

Die Sortierreihenfolge.

Verfügbare Werte:

• +created_at: älteste zuerst
• -created_at: neueste zuerst

Die Task-ID aus der Antwort der Erstellung.

Die Task-ID. Behandeln Sie sie als eine undurchsichtige Zeichenkette und verlassen Sie sich nicht auf ihr Format.

Der Task-Typ, immer print-split.

Download-URLs für das aufgeteilte Modell, eine pro angeforderten Format. Ein nicht angefordertes Format hat keinen Schlüssel. Formate, die Szenenobjekte unterstützen, behalten jedes Teil als separates Objekt bei, während stl die Teile zu einem festen Körper verschmilzt.

Download-URL für ein Vorschaubild des aufgeteilten Modells im angeforderten layout. Wenn die Teile eine Textur behalten, zeigt die Vorschau diese an. Andernfalls hat jedes Teil seine eigene Farbe.

Die Texturmaps des aufgeteilten Modells, als Array mit einem Objekt. Alle Teile teilen sich diese Maps. Nur vorhanden, wenn keep_texture auf true steht und das Eingabemodell texturiert ist.

Download-URL für eine Version von thumbnail_url mit transparentem Hintergrund (RGBA). Nur vorhanden, nachdem der Task erfolgreich war und Meshy die transparente Vorschau gerendert hat.

Ob Meshy den prompt ignoriert hat. Der Wert ist true, wenn der prompt einer by_parts- oder by_color-Anfrage keine Teile benannt hat, sodass Meshy das Modell stattdessen automatisch aufgeteilt hat. Die Teilnamen im Ergebnis stammen dann von Meshy, nicht von Ihnen. Vorhanden ab PENDING. Meshy lässt es bei auto-Tasks weg und immer dann, wenn es dem prompt gefolgt ist.

Die Anzahl der druckbaren Teile, die die Aufteilung erzeugt hat. Formate, die Szenenobjekte unterstützen, enthalten ein Objekt pro Teil. stl verschmilzt die Teile zu einem festen Körper, aber part_count zählt sie trotzdem. Vor dem Export entfernt Meshy kollabierte Splitter, die kein druckbares Teil werden können, und zählt sie nicht mit.

Wie viel des Tasks abgeschlossen ist, in Prozent. Der Wert ist 0, bis der Task startet, und 100, wenn er erfolgreich ist.

Der Task-Status, einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED oder CANCELED.

Die Anzahl der Tasks, die in der Warteschlange vor diesem liegen. Der Wert ist nur aussagekräftig, solange der Task PENDING ist.

Zeitpunkt, zu dem der Task erstellt wurde, in Unix-Millisekunden.

Zeitpunkt, zu dem der Task gestartet ist, in Unix-Millisekunden. Der Wert ist 0, bis der Task startet.

Zeitpunkt, zu dem der Task beendet wurde, in Unix-Millisekunden. Der Wert ist 0, bis der Task beendet ist.

Zeitpunkt, zu dem das Ergebnis des Tasks abläuft, in Unix-Millisekunden. Der Wert ist 0, bis der Task beendet ist.

Die Fehlerdetails, wenn der Task fehlschlägt. Siehe Fehler.

Wenn eine Sicherheitsprüfung das Eingabemodell ablehnt, schlägt der Task mit task_error.type auf invalid_input und task_error.code auf provider_content_refused fehl. Senden Sie ein anderes Modell. Siehe Fehler.

Wenn Meshy bei keep_texture: true die Textur nicht beibehalten kann, schlägt der Task mit task_error.code auf textured_split_refused fehl. Siehe Fehler.

Die Anzahl der Credits, die der Task verbraucht hat. Dieser Wert ist immer vorhanden. Er ist 10, nachdem Meshy den Task akzeptiert hat, und 0 bei einem FAILED-Task, da Meshy die Credits erstattet, wenn ein Task fehlschlägt. Auch das Löschen eines PENDING-Tasks erstattet sie.