Retexture API

Erzeugen Sie neue Texturen für ein vorhandenes 3D-Modell anhand eines Text-Prompts oder von Referenzbildern. Das Modell kann aus einem anderen Meshy-Task oder aus einer Modelldatei stammen.

POST/openapi/v1/retexture

Eine Neutexturierungs-Aufgabe erstellen

Erstellt eine Neutexturierungs-Aufgabe. Die Aufgabe läuft im Hintergrund. Wie lange eine Aufgabe in der Regel dauert, erfahren Sie unter Verarbeitungszeiten.

Request

POST

/openapi/v1/retexture

# 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
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

Parameter

Name
input_task_id
Type
string
Erforderlich
Description
Erforderlich, außer wenn Sie model_url senden. Die ID einer Aufgabe, die ein 3D-Modell zum Texturieren 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 Status SUCCEEDED hat. Meshy texturiert die GLB-Datei der Aufgabe.

Name
model_url
Type
string
Erforderlich
Description
Erforderlich, außer wenn Sie input_task_id senden. Das zu texturierende Modell, als öffentliche URL oder als Data URI. Wenn Sie beide senden, verwendet Meshy input_task_id.
Das Modell muss eine GLB-, glTF-, OBJ-, FBX- oder STL-Datei mit höchstens 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, zum Beispiel data:application/octet-stream;base64,<Ihre base64-kodierten Modelldaten>.
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 einmal pro Kopie zählt.
- Eine FBX-Datei muss binäres FBX 7.1 oder neuer sein.
- Eine GLB- oder glTF-Datei darf keine Draco-Kompression verwenden.

Senden Sie eine dieser drei Stil-Eingaben.

Name
text_style_prompt
Type
string
Erforderlich
Description
Erforderlich, außer wenn Sie image_style_url oder multiview_image_urls senden. Text, der die gewünschte Textur beschreibt, bis zu 800 Zeichen. Längerer Text gibt 400 zurück.

Name
image_style_url
Type
string
Erforderlich
Description
Erforderlich, außer wenn Sie text_style_prompt oder multiview_image_urls senden. 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 sowohl text_style_prompt als auch image_style_url senden, verwendet Meshy image_style_url.
Das Bild muss eine .jpg-, .jpeg-, .png- oder .webp-Datei mit höchstens 20 MB sein.
Die Textur passt möglicherweise nicht gut, wenn das Objekt im Bild eine sehr andere Form hat als das Modell.

Name
multiview_image_urls
Type
string[]
Erforderlich
Description
Erforderlich, außer wenn Sie text_style_prompt oder image_style_url senden. Ein bis vier Bilder desselben Objekts aus verschiedenen Ansichten. Das erste Bild ist die Hauptansicht (Vorderseite). Die Reihenfolge der übrigen Ansichten (links, hinten, rechts) spielt keine Rolle. Ein leeres Array oder mehr als vier Bilder gibt 400 zurück.
Jedes Bild folgt denselben Format- und Größenregeln wie image_style_url, höchstens 20 MB pro Bild. Sie können multiview_image_urls nicht mit text_style_prompt oder image_style_url kombinieren.
multiview_image_urls erfordert ein explizites "ai_model": "meshy-7". Jedes andere ai_model, einschließlich des Standards latest, gibt 400 zurück.

Name
ai_model
Type
string
Standard latest
Description
Das KI-Modell, das die Textur erzeugt.
Verfügbare Werte:
- meshy-6-lite
- meshy-6
- meshy-7
- 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_id oder einer model_url, die auf eine Meshy-Ausgabe verweist, verwenden Sie true, um das optimierte UV-Layout wiederzuverwenden.
- Für ein von Ihnen anderswo hochgeladenes Modell verwenden Sie true, um bereits gute UVs beizubehalten. Lassen Sie es auf false, damit Meshy neue UVs erzeugt, was für ein Modell ohne richtiges UV-Mapping geeignet ist.
Name
enable_pbr
Type
boolean
Standard false
Description
Ob zusätzlich zur Grundfarbe PBR-Texturen (Metallic, Roughness und Normal) erzeugt werden sollen. Mit meshy-6 erzeugt Meshy zudem eine Emission Map, außer bei einer texture_resolution von 8k. meshy-6-lite, meshy-7 und latest erzeugen keine Emission Map.
Name
texture_resolution
Type
string
Standard 2k
Description
Die Größe der Grundfarbtextur. Höhere Auflösungen erfassen mehr Oberflächendetails.
Verfügbare Werte:
- 2k: 2048 × 2048 Pixel
- 4k: 4096 × 4096 Pixel
- 8k: 8192 × 8192 Pixel
4k und 8k benötigen ein ai_model von meshy-6, meshy-7 oder latest. Mit meshy-6-lite geben sie 400 zurück. Bei 8k erzeugt Meshy keine Emission Map.
Name
hd_texture
Type
boolean
⚠ veraltet
Standard false
Description
Verwenden Sie stattdessen texture_resolution. true entspricht texture_resolution: "4k". Wenn Sie beide senden, verwendet Meshy texture_resolution.
Name
remove_lighting
Type
boolean
Standard true
Description
Ob Glanzlichter und Schatten aus der Grundfarbtextur entfernt werden sollen. Das Ergebnis funktioniert besser unter Ihrer eigenen Beleuchtung.
Meshy wendet dies nur mit meshy-6 an, bei einer texture_resolution von 2k oder 4k. Mit meshy-7 oder latest, oder bei 8k, akzeptiert Meshy den Parameter und ignoriert ihn. Mit meshy-6-lite gibt das Senden dieses Parameters mit beliebigem Wert 400 zurück.
Name
target_formats
Type
string[]
Description
Die zu erzeugenden Dateiformate. Meshy erzeugt nur die von Ihnen aufgelisteten Formate, was die Aufgabe verkürzen kann. Wenn Sie ihn weglassen, erzeugt Meshy jedes Format außer 3mf.
Verfügbare Werte:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Name
alpha_thumbnail
Type
boolean
Standard false
Description
Ob zusätzlich eine Vorschau mit transparentem Hintergrund (RGBA) gerendert werden soll, die beim Abrufen der Aufgabe in alpha_thumbnail_url zurückgegeben wird. thumbnail_url ändert sich dadurch nicht.

Rückgabe

Das Feld result der Antwort enthält die ID der neuen Neutexturierungs-Aufgabe.

Fehlerarten

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_url noch input_task_id wurde gesendet.
- Fehlender Stil: Keines von text_style_prompt, image_style_url und multiview_image_urls wurde gesendet.
- Widersprüchliche Stil-Eingaben: multiview_image_urls wurde zusammen mit text_style_prompt oder image_style_url gesendet.
- Nicht unterstütztes Modell für Mehransicht: multiview_image_urls wurde ohne explizites "ai_model": "meshy-7" gesendet.
- Ungültige Eingabeaufgabe: input_task_id ist keine erfolgreiche Aufgabe eines unterstützten Typs.
- Ungültiges Modellformat: Die model_url-Datei hat eine nicht unterstützte Dateiendung.
- Nicht erreichbare URL: Meshy kann die model_url-Datei, das image_style_url-Bild oder ein multiview_image_urls-Bild nicht herunterladen.
- Modelldatei zu groß: Die model_url-Datei 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 model_url-Datei ist größer als 100 MB und hat mehr als 10.000.000 Flächen. Verringern 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äre FBX- oder GLB-Datei.
- Nicht lesbare Modelldatei: Die model_url-Datei ist über 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 model_url-Datei ist über 100 MB, und ihr Header enthält zu viele Netze, Knoten oder Einträge zum Prüfen. Verringern Sie die Anzahl der Objekte in der Datei und senden Sie sie erneut.
- Bild zu groß: Das image_style_url-Bild oder ein multiview_image_urls-Bild ist größer als 20 MB.
Korrigieren Sie die Anfrage und senden Sie sie erneut. Siehe Fehler.
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. Aktualisieren Sie Ihren Plan in Ihren Abonnement-Einstellungen und versuchen Sie es erneut.
Name
403 - Forbidden
Description
input_task_id ist ein Flachrelief-Modell, das dieser Endpunkt nicht neu texturieren kann. Die Meldung lautet This model type does not support this operation. Senden Sie ein anderes Modell.
Name
404 - Not Found
Description
input_task_id stimmt 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.

GET/openapi/v1/retexture/:id

Eine Neutexturierung-Aufgabe abrufen

Gibt eine Neutexturierung-Aufgabe anhand ihrer ID zurück.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

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": {

    "message": ""

  },

  "consumed_credits": 10
}

Parameter

Name
id
Type
path
Description
Die Aufgaben-ID aus der Antwort der Erstellung.

Rückgabe

Das Neutexturierung-Aufgabenobjekt.

DELETE/openapi/v1/retexture/:id

Eine Neutexturierung-Aufgabe löschen

Löscht eine Neutexturierung-Aufgabe dauerhaft, einschließlich ihrer Modelle und Daten. Sie können eine Löschung nicht rückgängig machen.

Request

DELETE

/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f

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 zurück, die bei ihrer Erstellung verwendet wurden.

Eine IN_PROGRESS-Aufgabe kann nicht gelöscht werden. Die Anfrage liefert 409 Conflict, und die Aufgabe läuft weiter. Meshy erstattet keine Aufgabe, die bereits begonnen hat, sodass das Löschen Sie sowohl die Credits als auch das Ergebnis kosten würde. 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 wurde, oder 409 Conflict, wenn die Aufgabe IN_PROGRESS ist.

GET/openapi/v1/retexture

Liste der Neutexturierungs-Aufgaben

Gibt eine Liste Ihrer Neutexturierungs-Aufgaben zurück.

Request

GET

/openapi/v1/retexture

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"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

Parameter

Name
page_num
Type
integer
Standard 1
Description
Die zurückzugebende Seitenzahl.
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ückgabe

Eine paginierte Liste von Neutexturierungs-Aufgabenobjekten.

GET/openapi/v1/retexture/:id/stream

Streamen einer Neutexturierung-Aufgabe

Streamt die Updates einer Neutexturierung-Aufgabe als Server-Sent Events (SSE).

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Parameter

Name
id
Type
path
Description
Die Task-ID aus der Antwort des Erstellungsaufrufs.

Rückgabe

Ein Stream von Neutexturierung-Task-Objekten als Server-Sent Events.

Jedes Ereignis enthält das vollständige Task-Objekt, in derselben Form, die der Get-Endpunkt zurückgibt. Solange die Aufgabe PENDING oder IN_PROGRESS ist, besitzen ihre Ergebnisfelder noch keine Werte.

Das Retexture-Task-Objekt

Ein Retexture-Task-Objekt beschreibt eine Neutexturierung eines 3D-Modells. Es enthält den Status, den Fortschritt sowie die Modell- und Texturdateien, wenn der Task erfolgreich ist.

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Name
id
Type
string
Description
Die Task-ID. Behandeln Sie sie als undurchsichtige Zeichenkette 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_formats 3mf enthä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_urls erstellt 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_url mit transparentem Hintergrund (RGBA). Nur vorhanden, wenn Sie den Task mit alpha_thumbnail: true erstellt haben und Meshy die transparente Vorschau gerendert hat.
Name
progress
Type
integer
Description
Wie viel des Tasks abgeschlossen ist, in Prozent. Der Wert ist 0, bis der Task startet, und 100, wenn er erfolgreich ist.
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 abgeschlossen wurde, in Unix-Millisekunden. Der Wert ist 0, bis der Task abgeschlossen ist.
Name
status
Type
string
Description
Der Task-Status, einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED oder CANCELED.
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 aus, wenn Sie den Task mit enable_pbr: false erstellen.
- Name
  normal
  Type
  string
  Description
  Download-URL für die Normal Map. Meshy lässt dieses Feld aus, wenn Sie den Task mit enable_pbr: false erstellen.
- Name
  roughness
  Type
  string
  Description
  Download-URL für die Roughness-Map. Meshy lässt dieses Feld aus, wenn Sie den Task mit enable_pbr: false erstellen.
- Name
  emission
  Type
  string
  Description
  Download-URL für die Emission-Map. Meshy lässt dieses Feld aus, wenn Sie den Task mit einer der folgenden Optionen erstellen:
  
  enable_pbr: false
  
  ein ai_model von meshy-6-lite, meshy-7 oder latest
  
  texture_resolution: 8k
Name
preceding_tasks
Type
integer
Description
Die Anzahl der Tasks, die in der Warteschlange vor diesem liegen. Nur vorhanden, solange der Task PENDING ist.
Name
task_error
Type
object
Description
Die Fehlerdetails, wenn der Task fehlschlägt. Siehe Fehler.
Name
consumed_credits
Type
integer
Description
Die Anzahl der Credits, die der Task verbraucht hat. Vorhanden, wenn der Status PENDING, IN_PROGRESS oder SUCCEEDED ist. Bei einem FAILED-Task ist der Wert 0, da Meshy die Credits erstattet, wenn ein Task fehlschlägt.