Text zu 3D API

Dieses Feld sollte beim Erstellen einer Preview-Aufgabe auf "preview" gesetzt werden.

Beschreibt, um welche Art von Objekt es sich beim 3D-Modell handelt. Maximal 800 Zeichen.

Gibt die Art der 3D-Netzerzeugung an.

Verfügbare Werte:

• standard: Reguläre, hochdetaillierte 3D-Netzerzeugung.
• smart-topology: Wählt das Smart-Topology-Modell mit ai_model (meshy-t2).
• lowpoly (veraltet): Erzeugt ein Low-Poly-Netz, optimiert für sauberere Polygone. Wir empfehlen stattdessen smart-topology zu verwenden.

ID des zu verwendenden Modells. Die verfügbaren Werte hängen von model_type ab.

Standardgenerierung (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (veraltet): verwenden Sie stattdessen meshy-7.1.

Smart-Topology-Generierung (model_type: smart-topology):

• meshy-t2 (Standard): das Smart-Topology-Modell — sauberere topology, natürlich getrennte Teile, Dreiecks-Ausgabe und eine Flächenanzahl, die Sie mit target_polycount festlegen können.

Durchlauf zur Geometrieerzeugung. 2k führt den Ultra-Durchlauf mit 2048³ aus; 4k führt ihn mit 4096³ für die feinsten Oberflächendetails aus.

Verfügbare Werte: standard, 2k, 4k

Verwenden Sie stattdessen geometry_resolution. ultra_mode: true entspricht geometry_resolution: "2k".

Steuert, ob die Neuvernetzungsphase aktiviert wird. Für das qualitativ hochwertigste Modell empfehlen wir, should_remesh auf false zu setzen.

Zielanzahl der Polygone (Flächen) in der Ausgabe. Die tatsächliche Anzahl kann je nach Geometrie vom Zielwert abweichen.

target_polycount wirkt sich in zwei unabhängigen Fällen aus:

• Neuvernetzung — mit should_remesh: true bei einem standard-Modell. Das Netz wird auf ungefähr diese Anzahl neu vernetzt (dezimiert). Bereich 100 bis 300.000, Standardwert 30.000. Wenn decimation_mode gesetzt ist, hat es Priorität, und target_polycount wird ignoriert.
• Smart Topology — mit model_type: smart-topology und ai_model: meshy-t2. Das Modell wird direkt mit dieser Flächenanzahl generiert; es findet keine Neuvernetzung statt, und should_remesh ist nicht erforderlich. Bereich 100 bis 15.000, Standardwert 4.000.

Veraltet. Dieser Parameter beeinflusst die Ausgabe nicht mehr.

Das Feld symmetry_mode steuert das Symmetrieverhalten während des Modellgenerierungsprozesses.

Die gültigen Werte sind:

• off: Deaktiviert die Symmetrie.
• auto: Bestimmt und wendet die Symmetrie automatisch basierend auf der Eingabegeometrie an.
• on: Erzwingt Symmetrie während der Generierung.

Gibt den pose_mode für das generierte Modell an.

Verfügbare Werte:

• a-pose: Generiert das Modell in einer A-Pose.
• t-pose: Generiert das Modell in einer T-Pose.
• "" (leerer String): Keine spezifische Pose angewendet.

Verwenden Sie stattdessen pose_mode. Gibt an, ob das Modell in einer A/T-Pose generiert werden soll.

Wird von Meshy-6 nicht unterstützt. Anfragen mit Meshy-6 ignorieren art_style, und einige Kombinationen können Fehler verursachen. Verfügbare Werte: realistic, sculpture.

Wenn auf true gesetzt, wird der Eingabeinhalt automatisch auf potenziell schädliche Inhalte überprüft. Wird schädlicher Inhalt erkannt, wird die Aufgabe nicht zur Generierung fortgesetzt.

Der Text aus prompt wird überprüft.

Gibt an, welche 3D-Dateiformate in die Ausgabe aufgenommen werden sollen. Nur die angeforderten Formate werden generiert und zurückgegeben, was die Bearbeitungszeit der Aufgabe verkürzen kann. Wenn dies ausgelassen wird, werden alle unterstützten Formate einbezogen.

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

Wenn auf true gesetzt, rendert die Aufgabe zusätzlich eine Version der Vorschau mit transparentem Hintergrund (RGBA) und gibt sie als alpha_thumbnail_url in der GET-Antwort zurück. Das vorhandene Feld thumbnail_url bleibt unverändert.

Wenn auf true gesetzt, verwendet der Dienst KI-Vision, um automatisch die reale Höhe des Objekts zu schätzen und das Modell entsprechend in der Größe zu ändern. Der Ursprung wird standardmäßig auf bottom gesetzt, sofern origin_at nicht explizit gesetzt ist.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Ein erforderlicher Parameter (z. B. prompt, mode) fehlt.
• Ungültiger Parameter: art_style ist keiner der zulässigen Werte.
• Prompt zu lang: Der prompt überschreitet die Zeichenbegrenzung.
• Nicht unterstütztes Modell für Low Poly: ai_model: "meshy-6-lite" unterstützt model_type: "lowpoly" nicht.
• Nicht unterstütztes Modell für Ultra: geometry_resolution erfordert meshy-7.1 oder latest.

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

Unzureichende Credits, um diese Aufgabe auszuführen.

Sie haben Ihre Ratenbegrenzung überschritten.

Dieses Feld sollte beim Erstellen einer Refine-Aufgabe auf "refine" gesetzt werden.

Die zugehörige Preview-Aufgaben-ID.

Der Status der angegebenen Preview-Aufgabe muss SUCCEEDED sein.

Erzeugt zusätzlich zur Basisfarbe PBR-Texturen (Metallic, Roughness, Normal). Eine Emission Map wird ebenfalls einbezogen, wenn ai_model meshy-6 ist, außer bei texture_resolution: 8k (dort wird keine Emission Map erzeugt). meshy-6-lite, meshy-7.1 und latest erzeugen keine Emission Map.

Auflösung der Basisfarbtextur. Einer der Werte 2k (2048×2048), 4k (4096×4096) oder 8k (8192×8192). Höhere Auflösungen erfassen mehr Oberflächendetails. Gilt nur für den refine-Modus.

Verwenden Sie stattdessen texture_resolution — entspricht texture_resolution: "4k". Wenn beide gesetzt sind, hat texture_resolution Vorrang.

Geben Sie einen zusätzlichen Text-prompt an, um den Texturierungsprozess zu steuern. Maximal 800 Zeichen.

Geben Sie ein 2D-Bild an, um den Texturierungsprozess zu steuern. Wir unterstützen derzeit die Formate .jpg, .jpeg und .png.

Es gibt zwei Möglichkeiten, das Bild bereitzustellen:

• Öffentlich zugängliche URL: Eine URL, die aus dem öffentlichen Internet erreichbar ist
• Data URI: Ein base64-kodierter Data URI des Bildes. Beispiel für einen Data URI: data:image/jpeg;base64,<Ihre base64-kodierten Bilddaten>

ID des Modells, das für das Refine verwendet werden soll.

Verfügbare Werte:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (veraltet): verwenden Sie stattdessen meshy-7.1.

Lassen Sie diesen Parameter weg, um das von der Preview-Aufgabe verwendete Modell zu übernehmen, sodass eine Preview und ihr Refine durchgängig auf demselben Modell bleiben. Übergeben Sie einen expliziten Wert, um diese Übernahme zu überschreiben.

Wenn auf true gesetzt, wird der Eingabeinhalt automatisch auf potenziell schädliche Inhalte überprüft. Wird schädlicher Inhalt erkannt, wird die Aufgabe nicht zur Generierung fortgesetzt.

Sowohl der Text aus texture_prompt als auch das Bild aus texture_image_url werden überprüft.

Entfernt Glanzlichter und Schatten aus der Basisfarbtextur und erzeugt so ein saubereres Ergebnis, das unter benutzerdefinierten Beleuchtungssetups besser funktioniert.

Legt fest, welche 3D-Dateiformate in der Ausgabe enthalten sein sollen. Nur die angeforderten Formate werden generiert und zurückgegeben, was die Bearbeitungszeit der Aufgabe verkürzen kann. Wenn weggelassen, werden alle unterstützten Formate einbezogen.

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

Wenn auf true gesetzt, rendert die Aufgabe zusätzlich eine Version der Vorschau mit transparentem Hintergrund (RGBA) und gibt sie als alpha_thumbnail_url in der GET-Antwort zurück. Das bestehende Feld thumbnail_url bleibt unverändert.

Wenn auf true gesetzt, verwendet der Dienst KI-Vision, um automatisch die reale Höhe des Objekts zu schätzen und das Modell entsprechend in der Größe anzupassen. Der Ursprung ist standardmäßig bottom, sofern origin_at nicht explizit gesetzt ist.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Ungültige Aufgaben-ID: Die preview_task_id ist ungültig oder existiert nicht.
• Aufgabe nicht bereit: Die Preview-Aufgabe war noch nicht erfolgreich.
• Modell-Konflikt: Das KI-Modell der Preview-Aufgabe ist mit dem angeforderten Refine-Modell nicht kompatibel.

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

Unzureichende Credits, um diese Aufgabe auszuführen.

Die durch preview_task_id angegebene Preview-Aufgabe wurde nicht gefunden.

Sie haben Ihre Ratenbegrenzung überschritten.

Eindeutige Kennung für die abzurufende Text zu 3D-Aufgabe.

Die ID der zu löschenden Text zu 3D-Aufgabe.

Seitennummer für die Paginierung.

Begrenzung der Seitengröße. Maximal erlaubt sind 100 Einträge.

Feld, nach dem sortiert werden soll.

Verfügbare Werte:

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

Eindeutige Kennung der zu streamenden Text-zu-3D-Aufgabe.

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

Typ des Text zu 3D Tasks. Mögliche Werte sind text-to-3d-preview für Tasks der Preview-Stufe und text-to-3d-refine für Tasks der Refine-Stufe.

Herunterladbare URL zur texturierten 3D-Modelldatei, die von Meshy generiert wurde. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht generiert wurde, anstatt einen leeren String zurückzugeben.

Dies ist der unveränderte prompt, der zur Erstellung des Tasks verwendet wurde.

Wird aus Gründen der Abwärtskompatibilität beibehalten. Dieses Feld hat keine funktionale Auswirkung auf generierte Modelle.

Der unveränderte art_style, der zur Erstellung des Preview-Tasks verwendet wurde. Wird von Meshy-6 nicht unterstützt.

Wird aus Gründen der Abwärtskompatibilität beibehalten. Dieses Feld hat keine funktionale Auswirkung auf generierte Modelle.

Zusätzlicher Text-prompt, der bereitgestellt wird, um den Texturierungsprozess während der Refine-Stufe zu steuern.

Veraltet; lies stattdessen geometry_resolution.

Die Ultra-Stufe, mit der der Preview-Task ausgeführt wurde (2k oder 4k); wird bei standard weggelassen.

Herunterladbare URL zum Texturbild, das zur Steuerung des Texturierungsprozesses verwendet wurde.

Herunterladbare URL zum Miniaturansichtsbild der Modelldatei.

Herunterladbare URL zu einer Version von thumbnail_url mit transparentem Hintergrund (RGBA). Nur vorhanden, wenn der Task mit alpha_thumbnail: true erstellt wurde und die transparente Vorschau erfolgreich gerendert wurde; andernfalls wird dieses Feld weggelassen.

Herunterladbare URL zum Vorschauvideo. Wird in einer zukünftigen Version entfernt.

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

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

Zeitstempel, wann der Task erstellt wurde, in Millisekunden.

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

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

Ein Array von Textur-URL-Objekten, die aus dem Task generiert werden. Normalerweise enthält dies nur ein Textur-URL-Objekt. Jede Textur-URL hat die folgenden Eigenschaften:

Die Anzahl der vorangehenden Tasks.

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. Vorhanden, wenn der Task-Status PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt 0 für FAILED-Tasks zurück (Credits werden bei Fehlschlägen erstattet).