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, meshy-7.1 oder latest). Low-Poly- und Smart Topology-Modelle (meshy-t2) werden nicht unterstützt. Ein texturiertes Modell wird akzeptiert, seine Textur wird jedoch nicht in das Ergebnis übernommen.

Wie das Modell in Teile zerlegt wird.

Verfügbare Werte:

• auto: Meshy wählt die Schnitte. prompt wird ignoriert.
• by_parts: Schneidet entlang der strukturellen Teile, die Sie in prompt benennen, z. B. Kopf, Arme und Rumpf.
• by_color: Schneidet entlang der Farbregionen, die Sie in prompt benennen. Erfordert eine Eingabe, die aus einem hochgeladenen Bild erzeugt wurde (Bild zu 3D oder Multi-Bild zu 3D); andere Eingaben werden mit 400 abgelehnt. Die Grenzen der Farbregionen stammen aus dem Ausgangsbild, nicht aus der Textur des Eingabemodells. Bei Multi-Bild zu 3D verwendet Auto Split das erste Ausgangsbild.

Formate, in denen das aufgeteilte Modell exportiert werden soll. Formate, die Szenenobjekte unterstützen (glb, obj, fbx, usdz, blend, 3mf), führen jedes Teil als separates Objekt; stl kennt kein Konzept separater Objekte und verschmilzt daher jedes Teil zu einem einzigen Festkörper, angeordnet gemäß layout (fordern Sie 3mf an, wenn Sie in einem Slicer separat auswählbare Teile möchten). glb wird immer erzeugt und in model_urls zurückgegeben; listen Sie zusätzlich weitere gewünschte Formate auf.

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

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

Verfügbare Werte:

• assembled: Die Teile bleiben an der Stelle, an der sie sich im Quellmodell befanden.
• on_plate: Die Teile werden flach hingelegt und auf dem Druckbett verteilt, bereit zum Slicen – dieselbe Anordnung wie die On-Plate-Ansicht der Web-App.

In beiden Layouts wird ein durch einen Schnitt entstandener, zusammengefallener Splitter oder ein punktartiges Reststück vor dem Export entfernt, sodass jedes Teil, das Sie erhalten, druckbar ist. Formate, die Szenenobjekte unterstützen, enthalten ein Objekt pro Teil; stl verschmilzt sie zu einem einzigen Festkörper.

Fügt an jedem Schnitt Zapfen-und-Nut-Verbinder hinzu, damit die gedruckten Teile zusammenpassen.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Prompt: prompt ist erforderlich, wenn mode gleich by_parts oder by_color ist.
• Prompt beschreibt keine Aufteilung oder zu viele Teile: by_parts / by_color akzeptiert 1 bis 10 benannte Stücke. Eine Beschreibung, die verlangt, das Modell als ein Stück zu belassen, oder die mehr als 10 Teile benennt, wird abgelehnt. Es werden keine Credits 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.
• Kein Referenzbild: by_color erfordert eine Eingabe, die aus einem hochgeladenen Bild erzeugt wurde.
• Verbinderwert außerhalb des 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.

Das promptbasierte Aufteilen (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 werden keine Credits berechnet.

Die ID des abzurufenden Auto Split-Tasks.

Die ID des zu löschenden Auto-Split-Tasks.

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

Eindeutiger Bezeichner für den Task. Zwar verwenden wir als Implementierungsdetail eine k-sortierbare UUID für Task-IDs, du solltest jedoch 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. Formate, die Szenenobjekte unterstützen, behalten jeden Teil als separates Objekt bei; stl verschmilzt sie zu einem einzigen Volumenkörper. Die Eigenschaft für ein Format wird ausgelassen, wenn das Format nicht angefordert wurde.

Herunterladbare URL zu einer gerenderten Vorschau des aufgeteilten Modells, mit jedem Teil in einer eigenen Farbe, 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 Teilenamen im Ergebnis stammen dann von Meshy, nicht von dir. Ab PENDING vorhanden. Wird bei auto-Tasks und immer dann ausgelassen, wenn der Prompt befolgt wurde.

Anzahl der druckbaren Teile, die der Split erzeugt hat. Formate, die Szenenobjekte unterstützen, enthalten ein Objekt pro Teil; stl verschmilzt sie zu einem einzigen Volumenkörper, wobei die Anzahl weiterhin die Teile angibt. Kollabierte Splitter, aus denen die Segmentierung kein druckbares Stück 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 dieser Wert 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 wurde, 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 bei einem Fehlschlag rückerstattet wird. Das Löschen eines Tasks, während er sich noch in PENDING befindet, erstattet ihn ebenfalls zurück.