Text zu 3D API

Dieses Feld sollte auf "preview" gesetzt werden, wenn eine Vorschauaufgabe erstellt wird.

Beschreiben Sie, um welche Art von Objekt es sich beim 3D-Modell handelt. Maximal 600 Zeichen.

Geben Sie den Typ der 3D-Netz-Erzeugung an.

Verfügbare Werte:

• standard: Regelmäßige hochdetaillierte 3D-Netzerzeugung.
• lowpoly: Generiert ein Low-Poly-Netz, optimiert für saubere Polygone.

ID des zu verwendenden Modells. Verfügbare Werte: meshy-5, meshy-6, latest (Meshy 6).

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

Veraltet. Dieser Parameter beeinflusst die Ausgabe nicht mehr.

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

Die gültigen Werte sind:

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

Geben Sie den Pose-Modus 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 pose_mode stattdessen. Gibt an, ob das Modell in einer A-/T-Pose generiert werden soll.

Nicht unterstützt von Meshy-6. Anfragen, die Meshy-6 verwenden, 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. Wenn schädliche Inhalte erkannt werden, wird die Aufgabe nicht zur Generierung fortgesetzt.

Der Text aus prompt wird geprüft.

Gibt an, welche 3D-Dateiformate in die Ausgabe aufgenommen werden sollen. Nur die angeforderten Formate werden generiert und zurückgegeben, was die Dauer der Aufgabenfertigstellung verkürzen kann. Wenn weggelassen, 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 transparente (RGBA) Version der Vorschau und gibt sie als alpha_thumbnail_url in der GET-Antwort zurück. Das bestehende thumbnail_url-Feld bleibt unverändert.

Wenn auf true gesetzt, verwendet der Dienst KI-Vision, um die reale Höhe des Objekts automatisch zu schätzen und das Modell entsprechend zu skalieren. Der Ursprung wird standardmäßig auf unten gesetzt, es sei denn, origin_at ist ausdrücklich festgelegt.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Ein erforderlicher Parameter (z. B. prompt, mode) fehlt.
• Ungültiger Parameter: art_style ist nicht einer der erlaubten Werte.
• Prompt zu lang: Der prompt überschreitet die Zeichenbeschränkung.

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

Unzureichende Credits, um diese Aufgabe durchzuführen.

Sie haben Ihr Ratenlimit überschritten.

Dieses Feld sollte auf "refine" gesetzt werden, wenn eine Verfeinerungsaufgabe erstellt wird.

Die entsprechende Vorschauaufgaben-ID.

Der Status der angegebenen Vorschauaufgabe muss SUCCEEDED sein.

Erstellt PBR-Texturen (metallisch, Rauigkeit, Normal Map) zusätzlich zur Basisfarbe. Eine Emissionskarte wird ebenfalls enthalten, wenn ai_model meshy-6 oder latest ist, außer bei texture_resolution: 8k (keine Emissionskarte wird erzeugt).

Basisfarbentextur-Auflösung. Eine von 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 — äquivalent zu texture_resolution: "4k". Wenn beide festgelegt sind, hat texture_resolution Vorrang.

Geben Sie einen zusätzlichen Textprompt an, um den Texturierungsprozess zu leiten. Maximal 600 Zeichen.

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

Es gibt zwei Möglichkeiten, das Bild bereitzustellen:

• Öffentlich zugängliche URL: Eine URL, die vom öffentlichen Internet aus zugänglich ist.
• Data URI: Eine base64-codierte Data URI des Bildes. Beispiel einer Data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID des zu verwendenden Modells für die Verfeinerung. Verfügbare Werte: meshy-5, meshy-6, latest (Meshy 6).

Wenn auf true gesetzt, wird der Eingabeinhalt automatisch auf potenziell schädliche Inhalte überprüft. Wenn schädliche Inhalte erkannt werden, 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 Hervorhebungen und Schatten von der Basisfarbtextur, was zu einem saubereren Ergebnis führt, das besser unter benutzerdefinierten Beleuchtungseinstellungen funktioniert.

Gibt an, welche 3D-Dateiformate in die Ausgabe aufgenommen werden sollen. Nur die angeforderten Formate werden generiert und zurückgegeben, was die Dauer der Aufgabenfertigstellung verkürzen kann. Wenn weggelassen, 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 transparente (RGBA) Version der Vorschau und gibt sie als alpha_thumbnail_url in der GET-Antwort zurück. Das bestehende thumbnail_url-Feld bleibt unverändert.

Wenn auf true gesetzt, verwendet der Dienst KI-Vision, um die reale Höhe des Objekts automatisch zu schätzen und das Modell entsprechend zu skalieren. Der Ursprung wird standardmäßig auf unten gesetzt, es sei denn, origin_at ist ausdrücklich festgelegt.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Ungültige Aufgaben-ID: Die preview_task_id ist ungültig oder existiert nicht.
• Aufgabe noch nicht bereit: Die Vorschauaufgabe war noch nicht erfolgreich.
• Modelldiskrepanz: Das AI-Modell der Vorschauaufgabe ist mit dem angeforderten Verfeinerungsmodell nicht kompatibel.

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

Unzureichende Credits, um diese Aufgabe durchzuführen.

Die in preview_task_id angegebene Vorschauaufgabe wurde nicht gefunden.

Sie haben Ihr Ratenlimit überschritten.

Eindeutiger Identifikator für die abzurufende Text zu 3D Aufgabe.

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

Seitennummer für die Paginierung.

Seitengrößenlimit. Das Maximum beträgt 50 Einheiten.

Feld zum Sortieren.

Verfügbare Werte:

• +created_at: Sortieren nach Erstellungszeit in aufsteigender Reihenfolge.
• -created_at: Sortieren nach Erstellungszeit in absteigender Reihenfolge.

Eindeutiger Identifikator für die zu streamende Text zu 3D Aufgabe.

Eindeutiger Identifikator für die Aufgabe. Während wir eine k-sortierbare UUID für Aufgaben-IDs als Implementierungsdetail 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 Vorschauaufgaben und text-to-3d-refine für Verfeinerungsaufgaben.

Herunterladbare URL zur vom Meshy generierten texturierten 3D-Modell-Datei. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht generiert wurde, und gibt keinen leeren String zurück.

Dies ist der unmodifizierte prompt, der zur Erstellung der Aufgabe verwendet wurde.

Beibehalten für die Abwärtskompatibilität. Dieses Feld hat keine funktionale Auswirkung auf generierte Modelle.

Der unmodifizierte art_style, der zur Erstellung der Vorschauaufgabe verwendet wurde. Nicht unterstützt von Meshy-6.

Beibehalten für die Rückwärtskompatibilität. Dieses Feld hat keine funktionale Auswirkung auf generierte Modelle.

Zusätzlicher Textprompt, der bereitgestellt wird, um den Texturierungsprozess während der Verfeinerungsphase zu leiten.

Herunterladbare URL zum Texturbild, das zur Führung des Texturierungsprozesses verwendet wurde.

Herunterladbare URL zum Miniaturbild der Modella datei.

Herunterladbare URL zu einer transparenten (RGBA)-Version von thumbnail_url. Nur vorhanden, wenn die Aufgabe 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 der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, beträgt diese Eigenschaft 0. Sobald die Aufgabe erfolgreich abgeschlossen wurde, beträgt sie 100.

Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht gestartet wurde, beträgt dieser Eigenschaft 0.

Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden. Wenn die Aufgabe noch nicht abgeschlossen ist, beträgt 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 dies nur ein Textur-URL-Objekt. Jede Textur-URL hat folgende Eigenschaften:

Die Anzahl der vorhergehenden 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 0 für FAILED Aufgaben zurück (Credits werden bei einem Fehler zurückerstattet).