Text zu 3D API

Dieses Feld sollte beim Erstellen einer Vorschauaufgabe auf "preview" gesetzt werden.

Beschreibt, welche Art von Objekt das 3D-Modell darstellen soll. 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, das für sauberere Polygone optimiert ist. 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-5, meshy-6, meshy-7, latest (Meshy 7)

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

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

Aktiviert die Ultra-Generierung für eine höherwertige Geometrie mit feineren Oberflächendetails. Die Generierung dauert länger und kostet 5 zusätzliche Credits.

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. Ist decimation_mode gesetzt, 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 hat keinen Einfluss mehr auf die Ausgabe.

Das Feld symmetry_mode steuert das Symmetrieverhalten während der Modellgenerierung.

Die gültigen Werte sind:

• off: Deaktiviert Symmetrie.
• auto: Bestimmt und wendet 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.
• "" (leere Zeichenkette): Keine spezifische Pose angewendet.

Verwenden Sie stattdessen pose_mode. 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ädlichen Inhalt überprüft. Wird schädlicher Inhalt erkannt, wird die Aufgabe nicht zur Generierung weitergeführt.

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. Wird das Feld 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-Bildanalyse, um die reale Höhe des Objekts automatisch zu schätzen und das Modell entsprechend in der Größe anzupassen. Der Ursprung wird standardmäßig auf bottom gesetzt, sofern origin_at nicht explizit angegeben ist.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Ein erforderlicher Parameter (z. B. prompt, mode) fehlt.
• Ungültiger Parameter: art_style entspricht keinem der zulässigen Werte.
• Prompt zu lang: Der prompt überschreitet das Zeichenlimit.

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 Verfeinerungsaufgabe auf "refine" gesetzt werden.

Die entsprechende Vorschauaufgaben-ID.

Der Status der angegebenen Vorschauaufgabe muss SUCCEEDED sein.

Erzeugt zusätzlich zur Grundfarbe PBR-Texturen (metallic, roughness, normal). Eine Emissionsmap wird ebenfalls einbezogen, wenn ai_model den Wert meshy-6 hat, außer bei texture_resolution: 8k (hier wird keine Emissionsmap erzeugt). meshy-7 (und latest) erzeugt keine Emissionsmap.

Auflösung der Grundfarbtextur. 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-mode.

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. Derzeit werden die Formate .jpg, .jpeg und .png unterstützt.

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 zu verwendenden Modells für die Verfeinerung. Verfügbare Werte: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Wenn auf true gesetzt, wird der Eingabeinhalt automatisch auf potenziell schädliche Inhalte geprü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 geprüft.

Entfernt Glanzlichter und Schatten aus der Grundfarbtextur und erzeugt so ein saubereres Ergebnis, das unter individuellen Beleuchtungseinstellungen besser funktioniert.

Gibt an, welche 3D-Dateiformate in der Ausgabe enthalten sein sollen. Es werden nur die angeforderten Formate erzeugt und zurückgegeben, was die Fertigstellungszeit der Aufgabe verkürzen kann. Wenn nicht angegeben, sind alle unterstützten Formate enthalten.

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 diese 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-basiertes Sehen, um die reale Höhe des Objekts automatisch 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 Vorschauaufgabe war noch nicht erfolgreich.
• Modell-Inkompatibilität: Das KI-Modell der Vorschauaufgabe ist mit dem angeforderten Verfeinerungsmodell nicht kompatibel.

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

Nicht genügend Credits, um diese Aufgabe auszuführen.

Die durch preview_task_id angegebene Vorschauaufgabe wurde nicht gefunden.

Sie haben Ihre Ratenbegrenzung überschritten.

Eindeutige Kennung für den abzurufenden Text-zu-3D-Task.

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

Seitennummer für die Paginierung.

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

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 der zu streamenden Text-zu-3D-Aufgabe.

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

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

Herunterladbare URL zur texturierten 3D-Modelldatei, die von Meshy generiert wurde. Die Eigenschaft für ein Format wird ausgelassen, wenn das Format nicht generiert wurde, anstatt eine leere Zeichenfolge zurückzugeben.

Dies ist der unveränderte prompt, der zur Erstellung der Aufgabe 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 der Preview-Aufgabe 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 zur Steuerung des Texturierungsprozesses während der Refine-Phase bereitgestellt wird.

Gibt den Wert von ultra_mode wieder, mit dem die Preview-Aufgabe erstellt wurde. Nur vorhanden bei meshy-7- (oder latest-)Preview-Aufgaben, bei denen ultra_mode explizit gesetzt wurde; andernfalls ausgelassen.

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

Herunterladbare URL zur Miniaturansicht der Modelldatei.

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

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

Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald die Aufgabe erfolgreich abgeschlossen wurde, wird sie 100.

Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0.

Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden. Wenn die Aufgabe noch nicht abgeschlossen wurde, ist diese Eigenschaft 0.

Status der Aufgabe. Mögliche Werte sind PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Ein Array von Textur-URL-Objekten, die aus der Aufgabe generiert werden. Normalerweise enthält dieses nur ein Textur-URL-Objekt. Jede Textur-URL besitzt die folgenden Eigenschaften:

Die Anzahl der vorangehenden Aufgaben.

Fehlerdetails für fehlgeschlagene Aufgaben. Siehe Fehler für die vollständige Referenz des task_error-Objekts.

Die Anzahl der von dieser Aufgabe verbrauchten Credits. Vorhanden, wenn der Aufgabenstatus PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt für FAILED-Aufgaben 0 zurück (Credits werden bei Fehlschlag zurückerstattet).