Retexture API
Generiere neue Texturen für ein bestehendes 3D-Modell aus einem Text-Prompt oder Referenzbildern. Das Modell kann von einer anderen Meshy-Aufgabe oder aus einer Modelldatei stammen.
Erstellen einer Neutexturierungs-Aufgabe
Erstellt eine Neutexturierungs-Aufgabe. Die Aufgabe läuft im Hintergrund. Wie lange eine Aufgabe in der Regel dauert, erfahren Sie unter Verarbeitungszeiten.
Request
# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"enable_original_uv": true,
"enable_pbr": true
}'
# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
"image_style_url": "<your publicly accessible image url or base64-encoded data URI>",
"ai_model": "latest",
"enable_pbr": true,
"enable_original_uv": true
}'
# Retexture with Meshy N1 from front and back views
curl https://api.meshy.ai/openapi/v1/retexture \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
"ai_model": "meshy-n1",
"multiview_image_urls": [
"<your front view image url or data URI>",
"<your back view image url or data URI>"
]
}'
Response
{
"result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
Parameter
- Name
- input_task_id
- Type
- string
- Erforderlich
- Description
Erforderlich, sofern Sie nicht
model_urlsenden. Die ID einer Aufgabe, die ein zu texturierendes 3D-Modell erzeugt hat, zum Beispiel eine Text-zu-3D-, Bild-zu-3D-, Neuvernetzungs- oder Neutexturierungs-Aufgabe. Die Aufgabe muss eine sein, die Sie mit der API erstellt haben und den StatusSUCCEEDEDaufweist. Meshy texturiert das GLB der Aufgabe.Bei
meshy-n1darf das Modell der Aufgabe höchstens 7.999.999 Flächen aufweisen, gezählt als Dreiecke (ein Viereck zählt als 2).
- Name
- model_url
- Type
- string
- Erforderlich
- Description
Erforderlich, sofern Sie nicht
input_task_idsenden. Das zu texturierende Modell, als öffentliche URL oder als Data URI. Wenn Sie beides senden, verwendet Meshyinput_task_id.Das Modell muss eine GLB-, glTF-, OBJ-, FBX- oder STL-Datei von höchstens 400 MB von einer
http- oderhttps-URL sein, oder 100 MB als Data URI. Verwenden Sie für eine Data URI den MIME-Typapplication/octet-stream, zum Beispieldata:application/octet-stream;base64,<Ihre base64-kodierten Modelldaten>.Eine Datei über 100 MB muss zusätzlich diesen Regeln entsprechen:
- Eine GLB-, glTF-, FBX- oder OBJ-Datei darf höchstens 10.000.000 Flächen aufweisen. 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-Komprimierung verwenden.
Bei
meshy-n1darf das Modell höchstens 7.999.999 Flächen aufweisen, gezählt als Dreiecke (ein Viereck zählt als 2), unabhängig von der Dateigröße.
Senden Sie eine dieser drei Stil-Eingaben.
- Name
- text_style_prompt
- Type
- string
- Erforderlich
- Description
Erforderlich, sofern Sie nicht
image_style_urlodermultiview_image_urlssenden. Text, der die gewünschte Textur beschreibt, bis zu 800 Zeichen. Längerer Text gibt400zurück. Beimeshy-n1gibt das Senden ohneimage_style_url400zurück.
- Name
- image_style_url
- Type
- string
- Erforderlich
- Description
Erforderlich, sofern Sie nicht
text_style_promptodermultiview_image_urlssenden. Ein 2D-Bild, dessen Stil die Textur übernimmt, als öffentliche URL oder als Data URI (data:image/jpeg;base64,<Ihre base64-kodierten Bilddaten>). Wenn Sie sowohltext_style_promptals auchimage_style_urlsenden, verwendet Meshyimage_style_url.Das Bild muss eine
.jpg-,.jpeg-,.png- oder.webp-Datei von höchstens 20 MB sein und mindestens 32 Pixel auf jeder Seite aufweisen.Die Textur passt möglicherweise nicht gut, wenn das Objekt im Bild eine sehr andere Form als das Modell hat. Bei
meshy-n1behandelt Meshy das Bild als Vorderansicht.
- Name
- multiview_image_urls
- Type
- string[]
- Erforderlich
- Description
Erforderlich, sofern Sie nicht
text_style_promptoderimage_style_urlsenden. Ein bis vier Bilder desselben Objekts aus unterschiedlichen Ansichten. Das erste Bild ist die Hauptansicht (vorne). Die Reihenfolge der anderen Ansichten (links, hinten, rechts) spielt keine Rolle. Ein leeres Array oder mehr als vier Bilder geben400zurück.Jedes Bild folgt denselben Format- und Größenregeln wie
image_style_url, höchstens 20 MB pro Bild. Sie könnenmultiview_image_urlsnicht mittext_style_promptoderimage_style_urlkombinieren.multiview_image_urlserfordert ein explizitesai_modelvonmeshy-7odermeshy-n1. Jedes andereai_model, einschließlich des Standardslatest, gibt400zurück.
- Name
- ai_model
- Type
- string
- Standard latest
- Description
Das KI-Modell, das die Textur erzeugt.
Verfügbare Werte:
meshy-6-litemeshy-6meshy-7meshy-n1: eine 2K-Basisfarben-Textur ausschließlich aus Referenzbildern. Kein Text-Prompt, keine PBR-Texturen, kein 4K oder 8K. Bis zu 7.999.999 Flächen.latest: Meshy 7
- Name
- enable_original_uv
- Type
- boolean
- Standard false
- Description
Ob das UV-Layout des Modells beibehalten werden soll, anstatt ein neues zu erzeugen.
- Für ein von Meshy erzeugtes Modell, aus
input_task_idoder einermodel_url, die auf eine Meshy-Ausgabe verweist, verwenden Sietrue, um dessen optimiertes UV-Layout wiederzuverwenden. - Für ein Modell, das Sie von anderswo hochgeladen haben, verwenden Sie
true, um bereits gute UVs beizubehalten. Lassen Sie es auffalse, damit Meshy neue UVs erzeugt, was für ein Modell ohne richtiges UV-Mapping geeignet ist.
- Für ein von Meshy erzeugtes Modell, aus
- Name
- enable_pbr
- Type
- boolean
- Standard false
- Description
Ob zusätzlich zur Basisfarbe PBR-Texturen (metallic, roughness und normal) erzeugt werden sollen. Bei
meshy-6erzeugt Meshy außerdem eine Emissionskarte, außer bei einertexture_resolutionvon8k.meshy-6-lite,meshy-7undlatesterzeugen keine Emissionskarte. Beimeshy-n1gibttrue400zurück.
- Name
- texture_resolution
- Type
- string
- Standard 2k
- Description
Die Größe der Basisfarben-Textur. Höhere Auflösungen erfassen mehr Oberflächendetails.
Verfügbare Werte:
2k: 2048 × 2048 Pixel4k: 4096 × 4096 Pixel8k: 8192 × 8192 Pixel
4kund8kerfordern einai_modelvonmeshy-6,meshy-7oderlatest. Beimeshy-6-liteodermeshy-n1geben sie400zurück. Bei8kerzeugt Meshy keine Emissionskarte.
- Name
- hd_texture
- Type
- boolean
- ⚠ veraltet
- Standard false
- Description
Verwenden Sie stattdessen
texture_resolution.trueentsprichttexture_resolution: "4k". Wenn Sie beides senden, verwendet Meshytexture_resolution.
- Name
- remove_lighting
- Type
- boolean
- Standard true
- Description
Ob Glanzlichter und Schatten aus der Basisfarben-Textur entfernt werden sollen. Das Ergebnis funktioniert unter Ihrer eigenen Beleuchtung besser.
Meshy wendet dies nur bei
meshy-6an, bei einertexture_resolutionvon2koder4k. Beimeshy-7oderlatest, oder bei8k, akzeptiert Meshy den Wert und ignoriert ihn. Beimeshy-6-liteodermeshy-n1gibt das Senden mit einem beliebigen Wert400zurück.
- Name
- target_formats
- Type
- string[]
- Description
Die zu erzeugenden Dateiformate. Meshy erzeugt nur die aufgeführten Formate, was die Aufgabe verkürzen kann. Wenn Sie es weglassen, erzeugt Meshy jedes Format außer
3mf.Verfügbare Werte:
glbobjfbxstlusdz3mf
- Name
- alpha_thumbnail
- Type
- boolean
- Standard false
- Description
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 dadurch nicht.
Rückgabewerte
Das Feld result der Antwort enthält die ID der neuen Neutexturierungs-Aufgabe.
Fehlermodi
- Name
400 - Bad Request- Description
Die Anfrage kann nicht ausgeführt werden. Die Fehlermeldung gibt an, welches Problem gefunden wurde. Zum Beispiel:
- Fehlender Parameter: Weder
model_urlnochinput_task_idwurde gesendet. - Fehlender Stil: Keines von
text_style_prompt,image_style_urlundmultiview_image_urlswurde gesendet. - Widersprüchliche Stil-Eingaben:
multiview_image_urlswurde zusammen mittext_style_promptoderimage_style_urlgesendet. - Nicht unterstütztes Modell für Mehransicht:
multiview_image_urlswurde ohne explizitesai_modelvonmeshy-7odermeshy-n1gesendet. - Nicht unterstützte Option für Meshy N1:
meshy-n1wurde mitenable_pbr: true,remove_lighting, einertexture_resolutionvon4koder8k,hd_texture: trueohnetexture_resolution, odertext_style_promptohneimage_style_urlgesendet. - Zu viele Dreiecke für Meshy N1: Bei
meshy-n1hat das 3D-Modell mehr als 7.999.999 Dreiecke. Reduzieren Sie die Dreiecksanzahl, oder verwenden Sie ein anderesai_model. - Modell zu komplex für Meshy N1: Bei
meshy-n1ist diemodel_url-Datei zu komplex, damit Meshy ihre Dreiecke zählen kann. Reduzieren Sie die Dreiecksanzahl und senden Sie die Datei erneut. - Zeitüberschreitung bei der Dreieckszählung: Bei
meshy-n1hat das Zählen der Dreiecke dermodel_url-Datei zu lange gedauert. Versuchen Sie es erneut, oder verringern Sie die Größe des Modells. - Ungültige Eingabeaufgabe:
input_task_idist keine erfolgreiche Aufgabe eines unterstützten Typs. - Ungültiges Modellformat: Die
model_url-Datei hat eine nicht unterstützte Erweiterung. - Nicht erreichbare URL: Meshy kann die
model_url-Datei, dasimage_style_url-Bild oder einmultiview_image_urls-Bild nicht herunterladen. - Modelldatei zu groß: Die
model_url-Datei ist über 400 MB groß von einerhttp- oderhttps-URL, oder über 100 MB als Data URI. - Zu viele Flächen: Die
model_url-Datei ist über 100 MB groß 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
model_url-Datei ist eine ASCII-FBX-Datei über 100 MB. Senden Sie sie als binäres FBX oder GLB. - Nicht lesbare Modelldatei: Die
model_url-Datei ist über 100 MB groß, und Meshy kann ihren Header nicht lesen. Zum Beispiel ist es eine Draco-komprimierte GLB- oder glTF-Datei, oder ein binäres FBX älter als 7.1. - Modell-Header zu komplex: Die
model_url-Datei ist über 100 MB groß, und ihr Header enthält zu viele Netze, Knoten oder Datensätze, um geprüft zu werden. Reduzieren Sie die Anzahl der Objekte in der Datei und senden Sie sie erneut. - Bild zu groß: Das
image_style_url-Bild oder einmultiview_image_urls-Bild ist über 20 MB groß.
Bei
meshy-n1wird ein Modell, das Meshy vor dem Start der Aufgabe nicht prüfen kann, wie beispielsweise eine STL-Datei, hier nicht abgelehnt. Hat es mehr als 7.999.999 Dreiecke, schlägt die Aufgabe fehl, und Meshy erstattet die dafür verwendeten Credits.Beheben Sie die Anfrage und senden Sie sie erneut. Siehe Fehler.
- Fehlender Parameter: Weder
- Name
401 - Unauthorized- Description
Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den
Authorization-Header.
- Name
402 - Payment Required- Description
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. Führen Sie ein Upgrade Ihres Plans in Ihren Abonnement-Einstellungen durch und versuchen Sie es erneut.
- Name
403 - Forbidden- Description
Einer dieser Fälle trifft zu:
- Die Inhaltsmoderation hat den Prompt oder ein Eingabebild blockiert. Ändern Sie die Eingabe und versuchen Sie es erneut.
input_task_idist ein Flachrelief-Modell, das dieser Endpunkt nicht neu texturieren kann. Die Meldung lautetThis model type does not support this operation. Senden Sie ein anderes Modell.
- Name
404 - Not Found- Description
input_task_idstimmt mit keiner Ihrer Aufgaben überein. Überprüfen Sie die Aufgaben-ID und senden Sie die Anfrage erneut.
- Name
429 - Too Many Requests- Description
Sie haben Ihre Ratenbegrenzung überschritten. Warten Sie und versuchen Sie es erneut. Siehe Ratenbegrenzungen.
Eine Neutexturierungs-Aufgabe abrufen
Gibt eine Neutexturierungs-Aufgabe anhand ihrer ID zurück.
Request
curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
"mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"texture_image_url": "",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"task_error": null,
"consumed_credits": 10
}
Parameter
- Name
- id
- Type
- path
- Description
Die Aufgaben-ID aus der Erstellungsantwort.
Rückgabe
Eine Neutexturierung-Aufgabe löschen
Löscht eine Neutexturierung-Aufgabe dauerhaft, einschließlich ihrer Modelle und Daten. Ein Löschvorgang kann nicht rückgängig gemacht werden.
Request
curl --request DELETE \
--url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
"message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}
Pfadparameter
- Name
- id
- Type
- path
- Description
Die ID der zu löschenden Aufgabe.
Aufgabenstatus
Das Löschen einer PENDING-Aufgabe erstattet die Credits, die bei ihrer Erstellung verwendet wurden.
Eine IN_PROGRESS-Aufgabe kann nicht gelöscht werden. Die Anfrage gibt 409 Conflict
zurück, und die Aufgabe läuft weiter. Meshy erstattet keine Aufgabe, die bereits gestartet wurde,
daher würde das Löschen Sie sowohl die Credits als auch das Ergebnis kosten. Warten Sie, bis sie
SUCCEEDED, FAILED oder CANCELED erreicht, und löschen Sie sie dann.
Das Löschen einer Aufgabe in einem Endstatus (SUCCEEDED, FAILED oder CANCELED)
erstattet ihre Credits nicht.
Rückgabewerte
200 OK, wenn die Aufgabe gelöscht wird, oder 409 Conflict, wenn die Aufgabe
IN_PROGRESS ist.
Liste der Neutexturierungs-Aufgaben abrufen
Gibt eine Liste deiner Neutexturierungs-Aufgaben zurück.
Request
curl https://api.meshy.ai/openapi/v1/retexture?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
[
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"task_error": null,
"consumed_credits": 10
}
]
Parameter
- Name
- page_num
- Type
- integer
- Standard 1
- Description
Die zurückzugebende Seitenzahl, bis zu
255. Ein größerer Wert gibt400zurück.
- Name
- page_size
- Type
- integer
- Standard 10
- Description
Die Anzahl der Aufgaben pro Seite, bis zu
100.
- Name
- sort_by
- Type
- string
- Description
Die Sortierreihenfolge.
Verfügbare Werte:
+created_at: älteste zuerst-created_at: neueste zuerst
Rückgabewerte
Eine paginierte Liste von Neutexturierungs-Aufgabenobjekten.
Einen Neutexturierung-Task streamen
Streamt die Updates eines Neutexturierung-Tasks als Server-Sent Events (SSE).
Request
curl -N https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response Stream
// Error event example
event: error
data: {
"status_code": 404,
"message": "Task not found"
}
// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"progress": 0,
"status": "PENDING"
}
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"progress": 50,
"status": "IN_PROGRESS"
}
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"progress": 100,
"status": "SUCCEEDED",
"created_at": 1692771650657,
"started_at": 1692771667037,
"finished_at": 1692771669037,
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
"mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
},
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"task_error": null,
"consumed_credits": 10
}
Parameter
- Name
- id
- Type
- path
- Description
Die Task-ID aus der Antwort der Erstellung.
Rückgabe
Ein Stream von Neutexturierung-Task-Objekten als Server-Sent Events.
Jedes Event enthält das vollständige Task-Objekt, in derselben Form, die der Get-Endpunkt zurückgibt. Solange der Task PENDING oder IN_PROGRESS ist, haben seine Ergebnisfelder noch keine Werte.
Das Retexture-Task-Objekt
Ein Retexture-Task-Objekt beschreibt eine Neutexturierung eines 3D-Modells. Es enthält den Status, den progress sowie die Modell- und Texturdateien, wenn der Task erfolgreich abgeschlossen wird.
Eigenschaften
Example Retexture Task Model
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
},
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"task_error": null,
"consumed_credits": 10
}
- Name
- id
- Type
- string
- Description
Die Task-ID. Behandeln Sie sie als undurchsichtige Zeichenfolge und verlassen Sie sich nicht auf ihr Format.
- Name
- type
- Type
- string
- Description
Der Task-Typ, immer
retexture.
- Name
- model_urls
- Type
- object
- Description
Download-URLs für das texturierte 3D-Modell, eine pro Dateiformat.
- Name
glb- Type
- string
- Description
Die GLB-Datei.
- Name
fbx- Type
- string
- Description
Die FBX-Datei.
- Name
obj- Type
- string
- Description
Die OBJ-Datei.
- Name
usdz- Type
- string
- Description
Die USDZ-Datei.
- Name
mtl- Type
- string
- Description
Die MTL-Datei. Meshy liefert sie zusammen mit der OBJ-Datei, wenn das Modell Texturen hat.
- Name
stl- Type
- string
- Description
Die STL-Datei.
- Name
3mf- Type
- string
- Description
Die 3MF-Datei. Nur vorhanden, wenn
target_formats3mfenthält.
- Name
- text_style_prompt
- Type
- string
- Description
Der Text-prompt, mit dem Sie den Task erstellt haben.
- Name
- image_style_url
- Type
- string
- Description
Das Stilbild, mit dem Sie den Task erstellt haben.
- Name
- multiview_image_urls
- Type
- string[]
- Description
Download-URLs für die Mehransicht-Referenzbilder, mit denen Sie den Task erstellt haben. Nur vorhanden, wenn Sie den Task mit
multiview_image_urlserstellt haben.
- Name
- thumbnail_url
- Type
- string
- Description
Download-URL für eine Miniaturansicht des Modells.
- Name
- alpha_thumbnail_url
- Type
- string
- Description
Download-URL für eine Version von
thumbnail_urlmit transparentem Hintergrund (RGBA). Nur vorhanden, wenn Sie den Task mitalpha_thumbnail: trueerstellt haben und Meshy die transparente Vorschau gerendert hat.
- Name
- progress
- Type
- integer
- Description
Wie viel des Tasks erledigt ist, in Prozent. Der Wert ist
0, bis der Task startet, und100, wenn er erfolgreich abgeschlossen wird.
- Name
- started_at
- Type
- timestamp
- Description
Zeitpunkt, zu dem der Task gestartet wurde, in Unix-Millisekunden. Der Wert ist
0, bis der Task startet.
- Name
- created_at
- Type
- timestamp
- Description
Zeitpunkt, zu dem der Task erstellt wurde, in Unix-Millisekunden.
- Name
- expires_at
- Type
- timestamp
- Description
Zeitpunkt, zu dem die Ergebnisse des Tasks ablaufen, in Unix-Millisekunden.
- Name
- finished_at
- Type
- timestamp
- Description
Zeitpunkt, zu dem der Task beendet wurde, in Unix-Millisekunden. Der Wert ist
0, bis der Task beendet ist.
- Name
- status
- Type
- string
- Description
Der Task-Status, einer von
PENDING,IN_PROGRESS,SUCCEEDED,FAILEDoderCANCELED.
- Name
- texture_urls
- Type
- array
- Description
Download-URLs für die generierten Texturen, als Array von Objekten. Das Array enthält normalerweise ein Objekt. Jedes Objekt hat diese Felder:
- Name
base_color- Type
- string
- Description
Download-URL für die Basisfarb-Map.
- Name
metallic- Type
- string
- Description
Download-URL für die Metallic-Map. Meshy lässt dieses Feld weg, wenn Sie den Task mit
enable_pbr: falseerstellen.
- Name
normal- Type
- string
- Description
Download-URL für die Normal Map. Meshy lässt dieses Feld weg, wenn Sie den Task mit
enable_pbr: falseerstellen.
- Name
roughness- Type
- string
- Description
Download-URL für die Roughness-Map. Meshy lässt dieses Feld weg, wenn Sie den Task mit
enable_pbr: falseerstellen.
- Name
emission- Type
- string
- Description
Download-URL für die Emission-Map. Meshy lässt dieses Feld weg, wenn Sie den Task mit einer der folgenden Optionen erstellen:
enable_pbr: false- einem
ai_modelvonmeshy-6-lite,meshy-7oderlatest texture_resolution: 8k
- Name
- preceding_tasks
- Type
- integer
- Description
Die Anzahl der Tasks, die in der Warteschlange vor diesem stehen. Nur vorhanden, während der Task
PENDINGist; das Feld wird weggelassen, wenn der Wert0ist.
- Name
- task_error
- Type
- object
- Description
Die Fehlerdetails, wenn der Task fehlschlägt. Siehe Fehler.
- Name
- consumed_credits
- Type
- integer
- Description
Die Anzahl der vom Task verbrauchten Credits. Vorhanden, wenn der Status
PENDING,IN_PROGRESSoderSUCCEEDEDist. Bei einemFAILED-Task ist der Wert0, da Meshy die Credits erstattet, wenn ein Task fehlschlägt.