Auto Split API

Die ID eines erfolgreichen Tasks, dessen Modell aufgeteilt werden soll. Unterstützte Task-Typen: Bild zu 3D, Multi-Bild zu 3D, Text zu 3D (Vorschau), Neuvernetzung, Konvertieren und Größe ändern. Der Task muss den Status SUCCEEDED haben, und sein Modell muss mit Meshy 6 oder Meshy 7 erzeugt worden sein (ai_model meshy-6, meshy-7 oder latest). Low-Poly- und Smart-Topology-Modelle (meshy-t2) werden nicht unterstützt.

Wie das Modell in Teile aufgeteilt wird.

Verfügbare Werte:

• auto: Meshy wählt die Schnitte selbst. prompt wird ignoriert.
• by_parts: Schneidet entlang der strukturellen Teile, die Sie in prompt angeben, z. B. Kopf, Arme und Rumpf.
• by_color: Schneidet entlang der Farbbereiche, die Sie in prompt angeben. Erfordert eine Eingabe, die aus einem hochgeladenen Bild erzeugt wurde (Bild zu 3D oder Multi-Bild zu 3D); andere Eingaben werden mit 400 abgelehnt.

Formate, in denen das aufgeteilte Modell exportiert wird. Jedes Teil ist in jedem Format ein eigenes Objekt. glb wird immer erzeugt und in model_urls zurückgegeben; listen Sie zusätzlich beliebige weitere gewünschte Formate auf.

Verfügbare Werte: glb, obj, fbx, usdz, blend, 3mf.

3mf wird für Slicer geschrieben: ein Objekt pro Teil, jedes auf einem eigenen Filament-Slot, sodass Bambu Studio die Datei als einzeln eingefärbte, separat auswählbare Teile öffnet (das Archiv enthält eine Bambu-Studio-Projektkonfiguration; andere Slicer lesen die Geometrie). Wie die anderen Druckformate von Meshy ist es in Millimetern angegeben, und da dieser Endpunkt keine Zielgröße entgegennimmt, wird das gesamte Modell so skaliert, dass seine längste Seite 150 mm beträgt — dieselbe Obergrenze, die auch die anderen Druckformat-Exporte verwenden, gewählt, um auf jedes gängige Druckbett zu passen. Bei layout: "on_plate" gilt die Obergrenze für die gesamte angeordnete Platte, sodass die Datei bereit zum Slicen ist; bei assembled bleiben die Teile dort, wo das Ausgangsmodell sie hatte, und Sie ordnen sie im Slicer an.

Wie die Teile in jedem Ausgabeformat und in der Miniaturansicht angeordnet werden.

Verfügbare Werte:

• assembled: Die Teile bleiben dort, wo das Ausgangsmodell sie hatte.
• on_plate: Die Teile werden flach ausgelegt und auf dem Druckbett verteilt, bereit zum Slicen — dieselbe Anordnung wie die On-Plate-Ansicht der Web-App.

In beiden Layouts enthalten die exportierten Dateien genau ein Objekt pro Teil und sonst nichts: ein kollabierter Splitter oder ein punktförmiges Reststück eines Schnitts wird vor dem Export entfernt, sodass jedes Objekt in der Datei druckbar ist.

Fügt an jedem Schnitt Zapfenverbindungen (Nut-und-Feder) hinzu, damit die gedruckten Teile zusammenpassen.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Prompt: prompt ist erforderlich, wenn mode by_parts oder by_color ist.
• Prompt benennt weniger als zwei Teile: by_parts / by_color benötigt mindestens zwei benannte Teile (zum Beispiel head, torso, base); eine allgemeine Anweisung wie split into individual parts wird abgelehnt. Es wird nichts berechnet.
• Nicht unterstützter Eingabe-Task: input_task_id muss sich auf einen erfolgreichen Task eines unterstützten Typs beziehen, der mit Meshy 6 oder Meshy 7 erzeugt wurde.
• Texturierte Eingabe: Das Eingabemodell besitzt Texturen. Derzeit werden nur unteexturierte Modelle unterstützt.
• Kein Referenzbild: by_color erfordert eine Eingabe, die aus einem hochgeladenen Bild erzeugt wurde.
• Nicht unterstütztes Format: target_formats enthält stl.
• Verbinder außerhalb des zulässigen Bereichs: connector_size oder connector_height liegt außerhalb von 0.1 bis 0.8.

Die Authentifizierung ist fehlgeschlagen. Bitte überprüfen Sie Ihren API-Schlüssel.

Nicht genügend Credits, um diesen Task auszuführen.

Die input_task_id existiert nicht oder gehört nicht zu Ihrem Konto.

Sie haben Ihre Ratenbegrenzung überschritten. by_parts- und by_color-Anfragen teilen sich außerdem ein Prompt-Parsing-Limit von 12 Anfragen pro Minute und Konto.

Die promptbasierte Aufteilung (by_parts und by_color) ist vorübergehend nicht verfügbar. Versuchen Sie es später erneut oder verwenden Sie mode: "auto", das davon nicht betroffen ist. Es wird nichts berechnet.

Die ID des abzurufenden Auto Split-Tasks.

Die ID der zu löschenden Auto-Split-Aufgabe.

Seitennummer für die Paginierung. Beginnt bei und ist standardmäßig 1.

Begrenzung der Seitengröße. Standardmäßig 10 Elemente. Maximal zulässig sind 100 Elemente; größere Werte werden auf 100 begrenzt.

Feld, nach dem sortiert werden soll. Verfügbare Werte:

• +created_at: Sortierung nach Erstellungszeit in aufsteigender Reihenfolge.
• -created_at: Sortierung nach Erstellungszeit in absteigender Reihenfolge.

Eindeutige Kennung des Auto-Split-Tasks, der gestreamt werden soll.

Eindeutige Kennung für den Task. Auch wenn wir für Task-IDs als Implementierungsdetail eine k-sortierbare UUID verwenden, solltest du keine Annahmen über das Format der ID treffen.

Typ des Tasks. Der Wert ist print-split.

Herunterladbare URLs zum aufgeteilten Modell, eine pro angeforderten Format. Jeder Teil ist ein separates Objekt in der Datei. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht angefordert wurde.

Herunterladbare URL zu einer gerenderten Vorschau des aufgeteilten Modells, wobei jeder Teil in einer eigenen Farbe dargestellt wird, im angeforderten layout.

true, wenn bei einer by_parts- oder by_color-Anfrage der prompt keine Teile benannt hat, sodass Meshy das Modell stattdessen automatisch aufgeteilt hat — die Teilnamen im Ergebnis stammen dann von Meshy, nicht von dir. Ab PENDING vorhanden. Wird bei auto-Tasks und immer dann weggelassen, wenn der Prompt befolgt wurde.

Anzahl der druckbaren Teile im aufgeteilten Modell — eines pro Objekt in den exportierten Dateien. Zusammengefallene Splitter, aus denen die Segmentierung kein druckbares Teil machen konnte, werden vor dem Export aus den Dateien entfernt und nicht mitgezählt.

Fortschritt des Tasks. Wenn der Task noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald der Task erfolgreich war, wird sie zu 100.

Status des Tasks. Mögliche Werte sind PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Die Anzahl der vorausgehenden Tasks.

Zeitstempel, wann der Task erstellt wurde, in Millisekunden.

Zeitstempel, wann der Task gestartet wurde, in Millisekunden. Wenn der Task noch nicht gestartet wurde, ist diese Eigenschaft 0.

Zeitstempel, wann der Task beendet wurde, in Millisekunden. Wenn der Task noch nicht beendet ist, ist diese Eigenschaft 0.

Fehlerdetails für fehlgeschlagene Tasks. Siehe Fehler für die vollständige Referenz des task_error-Objekts.

Die Anzahl der von diesem Task verbrauchten Credits. Immer vorhanden: 10, sobald der Task angenommen wurde, und 0 bei FAILED-Tasks, da die Belastung im Fehlerfall zurückerstattet wird. Auch das Löschen eines Tasks, während er noch PENDING ist, erstattet ihn zurück.