Auto Split API

Die ID einer erfolgreich abgeschlossenen Aufgabe, deren Modell aufgeteilt werden soll. Unterstützte Aufgabentypen: Bild zu 3D, Multi-Bild zu 3D, Text zu 3D (Vorschau), Neuvernetzung, Konvertieren und Größe ändern. Die Aufgabe muss den Status SUCCEEDED haben, und ihr 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, meshy-t2.5) werden nicht unterstützt. Ein texturiertes Modell wird akzeptiert, seine Textur wird jedoch nicht in das Ergebnis übernommen.

Wie das Modell in Teile aufgeteilt wird.

Verfügbare Werte:

• auto: Meshy wählt die Schnitte aus. 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 Farbbereiche, 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 Farbbereiche stammen aus dem Quellbild, nicht aus der Textur des Eingabemodells. Bei Multi-Bild zu 3D verwendet Auto Split das erste Quellbild.

Formate, in denen das aufgeteilte Modell exportiert werden soll. Formate, die Szenenobjekte unterstützen (glb, obj, fbx, usdz, blend, 3mf), enthalten jedes Teil als separates Objekt; stl kennt kein Konzept separater Objekte, sodass es alle Teile zu einem einzigen Körper verschmilzt, der gemäß layout angeordnet wird (fordern Sie 3mf an, um einzeln auswählbare Teile in einem Slicer zu erhalten). glb wird immer erzeugt und in model_urls zurückgegeben; listen Sie alle weiteren gewünschten Formate zusätzlich auf.

Verfügbare Werte: glb, obj, fbx, stl, 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 Quellmodell waren.
• on_plate: Die Teile werden flach ausgelegt und auf der Druckplatte verteilt, bereit zum Slicen — die gleiche Anordnung wie in der On-Plate-Ansicht der Web-App.

In beiden Layouts wird ein zusammengefallener Splitter oder ein punktartiges Übrigbleibsel eines Schnitts 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 Körper.

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

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Prompt: prompt ist erforderlich, wenn mode auf by_parts oder by_color gesetzt ist.
• Prompt beschreibt keine Aufteilung oder zu viele Teile: by_parts / by_color akzeptiert 1 bis 10 benannte Einzelteile. Eine Beschreibung, die verlangt, das Modell als ein Stück zu belassen, oder mehr als 10 Teile benennt, wird abgelehnt. Es werden keine Credits berechnet.
• Nicht unterstützte Eingabeaufgabe: input_task_id muss sich auf eine erfolgreich abgeschlossene Aufgabe eines unterstützten Typs beziehen, die mit Meshy 6 oder Meshy 7 erzeugt wurde.
• Kein Referenzbild: by_color erfordert eine Eingabe, die aus einem hochgeladenen Bild erzeugt wurde.
• Verbinder außerhalb des gültigen 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 diese Aufgabe 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 zudem ein Prompt-Parsing-Limit von 12 Anfragen pro Minute und Konto.

Promptbasiertes 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 Einträge. Maximal erlaubt sind 100 Einträge; 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. Auch wenn wir als Implementierungsdetail eine k-sortierbare UUID für Task-IDs verwenden, sollten Sie keine Annahmen über das Format der ID treffen.

Typ des Tasks. Der Wert ist print-split.

Herunterladbare URLs zum gesplitteten Modell, eine pro angeforderten Format. Formate, die Szenenobjekte unterstützen, behalten jedes Teil als separates Objekt; stl verschmilzt sie zu einem einzigen Festkörper. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht angefordert wurde.

Herunterladbare URL zu einer gerenderten Vorschau des gesplitteten Modells, wobei jedes Teil eine eigene Farbe hat, im angeforderten layout.

true, wenn der prompt einer by_parts- oder by_color-Anfrage keine Teile benannt hat, sodass Meshy das Modell stattdessen automatisch gesplittet hat – die Teilenamen im Ergebnis stammen dann von Meshy, nicht von Ihnen. Ab PENDING vorhanden. Entfällt bei auto-Tasks und immer dann, wenn dem prompt gefolgt 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 Festkörper, wobei die Anzahl weiterhin die Teile angibt. 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 wurde, 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 vorangehenden Tasks.

Zeitstempel der Erstellung des Tasks, in Millisekunden.

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

Zeitstempel des Abschlusses des Tasks, in Millisekunden. Wenn der Task noch nicht abgeschlossen ist, ist diese Eigenschaft 0.

Fehlerdetails für fehlgeschlagene Tasks. Die vollständige Referenz zum task_error-Objekt finden Sie unter Fehler. Wenn die Sicherheitsprüfung des Modellanbieters das Eingabemodell ablehnt, schlägt der Task mit task_error.type invalid_input und code provider_content_refused fehl. Siehe Fehler.

Die Anzahl der von diesem Task verbrauchten Credits. Immer vorhanden: 10, sobald der Task akzeptiert wurde, und 0 bei FAILED-Tasks, da die Belastung bei einem Fehlschlag erstattet wird. Auch das Löschen eines Tasks, während er noch PENDING ist, führt zu einer Erstattung.