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 generiert 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. prompt wird ignoriert.
• by_parts: Schneidet entlang der strukturellen Teile, die Sie in prompt benennen, wie Kopf, Arme und Rumpf.
• by_color: Schneidet entlang der Farbbereiche, die Sie in prompt benennen. Erfordert eine Eingabe, die aus einem hochgeladenen Bild generiert wurde (Bild zu 3D oder Multi-Bild zu 3D); andere Eingaben werden mit 400 abgelehnt.

Formate, in denen das aufgeteilte Modell exportiert werden soll. Jedes Teil ist ein separates Objekt in jedem Format. glb wird immer erzeugt und in model_urls zurückgegeben; listen Sie zusätzlich alle weiteren gewünschten Formate auf.

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

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

Verfügbare Werte:

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

In beiden Layouts enthalten die exportierten Dateien pro Teil genau ein Objekt und sonst nichts: Ein zusammengefallener Splitter oder ein punktartiges Reststück eines Schnitts wird vor dem Export entfernt, sodass jedes Objekt, das Sie in der Datei finden, druckbar ist.

Fügt an jedem Schnitt Zapfen-Verbinder (mortise-and-tenon) 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: Die input_task_id muss sich auf einen erfolgreichen Task eines unterstützten Typs beziehen, der mit Meshy 6 oder Meshy 7 generiert wurde.
• Texturierte Eingabe: Das Eingabemodell hat Texturen. Derzeit werden nur unt exturierte Modelle unterstützt.
• Kein Referenzbild: by_color erfordert eine Eingabe, die aus einem hochgeladenen Bild generiert wurde.
• Nicht unterstütztes Format: target_formats enthält stl.
• Verbinder 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.

Unzureichende 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 zusätzlich ein Prompt-Parsing-Limit von 12 Anfragen pro Minute und Konto.

Prompt-basierte 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 als Implementierungsdetail eine k-sortierbare UUID für Task-IDs 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. Jedes Teil ist ein eigenes Objekt in der Datei. 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 im prompt einer by_parts- oder by_color-Anfrage keine Teile benannt wurden und Meshy das Modell deshalb stattdessen automatisch aufgeteilt hat — die Teilnamen im Ergebnis stammen dann von Meshy, nicht von dir. Vorhanden ab PENDING. Wird bei auto-Tasks und immer dann ausgelassen, wenn der Prompt befolgt wurde.

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

Fortschritt des Tasks. Wenn der Task noch nicht gestartet ist, ist diese Eigenschaft 0. Sobald der Task erfolgreich war, wird sie 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 ist, 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 bei einem Fehlschlag rückerstattet wird. Das Löschen eines Tasks, während er sich noch im Status PENDING befindet, führt ebenfalls zu einer Rückerstattung.