Neuvernetzungs-API

Erforderlich, sofern Sie nicht model_url senden. Die ID der Aufgabe, deren Modell Sie neu vernetzen möchten, zum Beispiel eine Text-zu-3D-, Bild-zu-3D-, Neutexturierungs- oder Neuvernetzungs-Aufgabe. Die Aufgabe muss von Ihnen über die API erstellt worden sein und den Status SUCCEEDED haben.

Erforderlich, sofern Sie nicht input_task_id senden. Das neu zu vernetzende Modell, als öffentliche URL oder als Data URI. Wenn Sie beides senden, verwendet Meshy input_task_id.

Das Modell muss eine GLB-, glTF-, OBJ-, FBX- oder STL-Datei mit maximal 400 MB von einer http- oder https-URL sein, oder 100 MB als Data URI. Verwenden Sie für eine Data URI den MIME-Typ application/octet-stream.

Eine Datei über 100 MB muss zusätzlich diese Regeln erfüllen:

• Eine GLB-, glTF-, FBX- oder OBJ-Datei darf höchstens 10.000.000 Flächen haben. Meshy zählt Flächen als Dreiecke, sodass ein Viereck als 2 zählt und ein mehrfach gezeichnetes Netz pro Kopie einmal zählt.
• Eine FBX-Datei muss binäres FBX 7.1 oder neuer sein.
• Eine GLB- oder glTF-Datei darf keine Draco-Kompression verwenden.

Die zu erzeugenden Dateiformate.

Verfügbare Werte:

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

Der Flächentyp des neu vernetzten Modells.

Verfügbare Werte:

• quad: ein überwiegend aus Vierecken bestehendes Netz
• triangle: ein dezimiertes Dreiecksnetz

Die angestrebte Anzahl an Flächen, von 100 bis 300000. Das Ergebnis kann je nach Geometrie des Modells vom Zielwert abweichen. Ein Wert außerhalb des Bereichs liefert 400.

Adaptive Flächenanzahl, nach Stufe. Wenn Sie diesen Wert setzen, ignoriert Meshy target_polycount.

Verfügbare Werte:

• 1: ultra
• 2: hoch
• 3: mittel
• 4: niedrig

Verwenden Sie stattdessen die Resize API. Die Höhe, auf die das Modell skaliert werden soll, in Metern. Senden Sie höchstens einen der Parameter resize_height, resize_longest_side und auto_size.

Verwenden Sie stattdessen die Resize API. Die Länge, auf die die längste Seite des Begrenzungsrahmens des Modells skaliert werden soll, in Metern. Senden Sie höchstens einen der Parameter resize_height, resize_longest_side und auto_size.

Verwenden Sie stattdessen die Resize API. Ob die reale Höhe des Objekts mit KI-Bildanalyse geschätzt und das Modell darauf skaliert werden soll. Senden Sie höchstens einen der Parameter resize_height, resize_longest_side und auto_size.

Verwenden Sie stattdessen die Resize API. Wo der Ursprung des Modells platziert werden soll, bottom oder center. Der Standardwert gilt, wenn Sie resize_height, resize_longest_side oder auto_size senden. Ohne einen dieser Parameter verschiebt Meshy den Ursprung nur, wenn Sie origin_at senden.

Verwenden Sie stattdessen die Convert API. Ob das Modell nur in target_formats konvertiert werden soll. Wenn true, ignoriert Meshy topology, target_polycount, decimation_mode, resize_height, resize_longest_side und auto_size, prüft jedoch weiterhin deren Werte, sodass ein ungültiger Wert 400 zurückgibt. Mit convert_format_only: true gibt ein leeres oder null-target_formats 400 zurück.

Ob zusätzlich eine Vorschau mit transparentem Hintergrund (RGBA) gerendert werden soll, zurückgegeben in alpha_thumbnail_url, wenn Sie die Aufgabe abrufen. thumbnail_url ändert sich nicht.

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

• Fehlender Parameter: Weder model_url noch input_task_id wurde gesendet.
• Ungültige Eingabeaufgabe: input_task_id ist keine erfolgreiche API-Aufgabe, oder ihr KI-Modell unterstützt keine Neuvernetzung.
• Ungültiges Modellformat: Die Datei unter model_url hat eine nicht unterstützte Dateierweiterung.
• Nicht erreichbare URL: Meshy kann die Datei unter model_url nicht herunterladen.
• Modelldatei zu groß: Die Datei unter model_url ist größer als 400 MB von einer http- oder https-URL, oder größer als 100 MB als Data URI.
• Zu viele Flächen: Die Datei unter model_url ist größer als 100 MB und hat mehr als 10.000.000 Flächen. Reduzieren Sie die Flächenanzahl und senden Sie die Datei erneut.
• ASCII-FBX über 100 MB: Die Datei unter model_url ist eine ASCII-FBX-Datei über 100 MB. Senden Sie sie als binäre FBX- oder GLB-Datei.
• Nicht lesbare Modelldatei: Die Datei unter model_url ist größer als 100 MB, und Meshy kann ihren Header nicht lesen. Zum Beispiel handelt es sich um eine Draco-komprimierte GLB- oder glTF-Datei oder um eine binäre FBX-Datei älter als 7.1.
• Modell-Header zu komplex: Die Datei unter model_url ist größer als 100 MB, und ihr Header enthält zu viele Netze, Knoten oder Einträge zum Prüfen. Reduzieren Sie die Anzahl der Objekte in der Datei und senden Sie sie erneut.
• Ungültige Topologie: topology ist weder quad noch triangle.
• Sich gegenseitig ausschließende Parameter: Die Anfrage enthält mehr als einen der Parameter auto_size, resize_height und resize_longest_side. Senden Sie nur einen.

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 diese Aufgabe, oder das Konto hat ein Credit-Limit erreicht. Überprüfen Sie Ihr Credit-Guthaben und versuchen Sie es erneut.
• Kostenloser Plan: Das Erstellen einer Aufgabe erfordert einen kostenpflichtigen Plan. Aktualisieren Sie Ihren Plan in Ihren Abonnement-Einstellungen und versuchen Sie es erneut.

input_task_id ist ein Flachrelief-Modell, das dieser Endpunkt nicht neu vernetzen kann. Die Meldung lautet This model type does not support this operation. Senden Sie ein anderes Modell.

input_task_id stimmt mit keiner Ihrer Aufgaben überein. Überprüfen Sie die Aufgaben-ID und senden Sie die Anfrage erneut.

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

Die Task-ID aus der Antwort der Erstellung.

Die ID der zu löschenden Aufgabe.

Die zurückzugebende Seitenzahl.

Die Anzahl der Tasks pro Seite, bis zu 100.

Die Sortierreihenfolge.

Verfügbare Werte:

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

Die Task-ID aus der Antwort der Erstellung.

Die Aufgaben-ID. Behandeln Sie sie als undurchsichtige Zeichenfolge und verlassen Sie sich nicht auf ihr Format.

Der Aufgabentyp, immer remesh.

Download-URLs für das neu vernetzte Modell, eine pro Dateiformat. Ein Format, das die Aufgabe nicht erzeugt hat, besitzt keinen Schlüssel, anstatt eine leere Zeichenfolge zu sein.

Download-URL für ein Vorschaubild des neu vernetzten Modells.

Download-URL für eine Version von thumbnail_url mit transparentem Hintergrund (RGBA). Nur vorhanden, wenn Sie die Aufgabe mit alpha_thumbnail: true erstellt haben und Meshy die transparente Vorschau gerendert hat.

Wie viel von der Aufgabe erledigt ist, als Prozentsatz. Der Wert ist 0, bis die Aufgabe beginnt, und 100, wenn sie erfolgreich abgeschlossen wird.

Der Aufgabenstatus, einer von PENDING, IN_PROGRESS, SUCCEEDED oder FAILED.

Die Anzahl der Aufgaben, die dieser in der Warteschlange vorausgehen. Der Wert ist nur aussagekräftig, solange die Aufgabe PENDING ist.

Zeitpunkt, zu dem die Aufgabe erstellt wurde, in Unix-Millisekunden.

Zeitpunkt, zu dem die Aufgabe gestartet wurde, in Unix-Millisekunden. Der Wert ist 0, bis die Aufgabe beginnt.

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

Die Fehlerdetails, wenn die Aufgabe fehlschlägt. Siehe Fehler.

Die Anzahl der von der Aufgabe verbrauchten Credits. Vorhanden, wenn der Status PENDING, IN_PROGRESS oder SUCCEEDED ist. Bei einer FAILED-Aufgabe ist der Wert 0, da Meshy die Credits erstattet, wenn eine Aufgabe fehlschlägt.