Multi-Bild zu 3D API

Multi-Bild zu 3D API ist eine Funktion, die es Ihnen ermöglicht, Meshys Multi-Bild zu 3D-Fähigkeiten in Ihre eigene Anwendung zu integrieren. In diesem Abschnitt finden Sie alle Informationen, die Sie benötigen, um mit dieser API zu beginnen.

POST/openapi/v1/multi-image-to-3d

Erstelle eine Multi-Bild zu 3D Aufgabe

Dieser Endpunkt ermöglicht es Ihnen, eine neue Multi-Bild zu 3D-Aufgabe zu erstellen. Siehe Das Multi-Bild zu 3D Aufgabenobjekt, um zu sehen, welche Eigenschaften im Multi-Bild zu 3D Aufgabenobjekt enthalten sind.

Parameter

Nur einer von input_task_id oder image_urls ist erforderlich. Wenn beide angegeben sind, hat input_task_id Vorrang.

Name
input_task_id
Type
string
Erforderlich
Description
Die ID einer abgeschlossenen Bildgenerierungsaufgabe, deren Ausgabe (1-4 Bilder) als Eingabe verwendet werden soll. Diese Aufgabe muss eine der folgenden Aufgaben sein: Text zu Bild, Bild zu Bild, Text zu Bild Mehransicht oder Bild zu Bild Mehransicht. Zudem muss sie über die API ausgeführt worden sein und den Status SUCCEEDED haben.

Name
image_urls
Type
array
Erforderlich
Description
Stellen Sie 1 bis 4 Bilder für Meshy zur Verfügung, um das Modell zu erstellen. Derzeit unterstützen wir .jpg, .jpeg und .png Formate. Alle Bilder sollten dasselbe Objekt aus verschiedenen Blickwinkeln darstellen, um die besten Ergebnisse zu erzielen.
Es gibt zwei Möglichkeiten, jedes Bild bereitzustellen:
- Öffentlich zugängliche URL: Eine URL, die aus dem öffentlichen Internet zugänglich ist.
- Data URI: Eine base64-codierte Data URI des Bildes. Beispiel für eine Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
Bei meshy-7 (oder latest) wird das erste Bild als primäre (vordere) Ansicht verwendet. Die Reihenfolge der übrigen Bilder spielt keine Rolle.

Name
ai_model
Type
string
Standard latest
Description
Die ID des zu verwendenden Modells. Verfügbare Werte: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
should_texture
Type
boolean
Standard true
Description
Bestimmt, ob Texturen generiert werden. Wenn auf false gesetzt, wird die Texturphase übersprungen, und Sie erhalten ein Netz ohne Texturen.

Gilt nur wenn should_texture = true

Name
enable_pbr
Type
boolean
Standard false
Description
Generieren Sie PBR-Maps (metallisch, Rauheit, Normal) zusätzlich zur Basisfarbe. Eine Emissionskarte ist ebenfalls enthalten, wenn ai_model meshy-6 ist, mit Ausnahme von texture_resolution: 8k. meshy-7 und latest erzeugen keine Emissionskarte.
Name
texture_resolution
Type
string
Standard 2k
Description
Basisfarbtextur-Auflösung. Eine von 2k (2048×2048), 4k (4096×4096) oder 8k (8192×8192). Höhere Auflösungen erfassen mehr Oberflächendetails.
4k und 8k erfordern ai_model meshy-6, meshy-7 oder latest. Bei 8k wird keine Emissionskarte erzeugt.
Name
hd_texture
Type
boolean
⚠ veraltet
Standard false
Description
Verwenden Sie texture_resolution stattdessen — entspricht texture_resolution: "4k". Wenn beide festgelegt sind, hat texture_resolution Vorrang.
Name
texture_prompt
Type
string
Description
Geben Sie ein Text-prompt an, um den Texturierungsprozess zu leiten. Maximal 600 Zeichen.
Name
texture_image_url
Type
string
Description
Geben Sie ein 2D-Bild an, um den Texturierungsprozess zu leiten. Derzeit unterstützen wir .jpg, .jpeg und .png Formate.
Es gibt zwei Möglichkeiten, das Bild bereitzustellen:
- Öffentlich zugängliche URL: Eine URL, die aus dem öffentlichen Internet zugänglich ist
- Data URI: Eine base64-codierte Data URI des Bildes. Beispiel für eine Data URI: data:image/jpeg;base64,<your base64-encoded image data>
Die Bildtexturierung funktioniert möglicherweise nicht optimal, wenn erhebliche geometrische Unterschiede zwischen dem ursprünglichen asset und dem hochgeladenen Bild bestehen. Nur einer von texture_image_url oder texture_prompt kann verwendet werden, um den Texturierungsprozess zu leiten. Wenn beide Parameter angegeben sind, wird texture_prompt standardmäßig verwendet, um das Modell zu texturieren.

Name
should_remesh
Type
boolean
Standard false (meshy-6), true (others)
Description
Bestimmt, ob die Neuvernetzung aktiviert werden soll. Für das qualitativ hochwertigste Modell empfehlen wir, should_remesh auf false zu setzen.

Gilt nur wenn should_remesh = true

Name
topology
Type
string
Standard triangle
Description
Geben Sie die Netz-Topologie des generierten Modells an.
Verfügbare Werte:
- quad: Erstelle ein quad-dominantes Netz.
- triangle: Erstelle ein dezimiertes Dreiecksnetz.
Name
target_polycount
Type
integer
Standard 30,000
Description
Geben Sie die Zielanzahl der Polygone im generierten Modell an. Die tatsächliche Anzahl der Polygone kann je nach Geometriekomplexität von der Zielanzahl abweichen.
Der gültige Wertebereich variiert je nach Nutzerstufe:
- 100 bis 300.000 (einschließlich)
Name
decimation_mode
Type
integer
Description
Aktivieren Sie die adaptive Dezimierung, indem Sie ein Polycount-Level einstellen. Wenn eingestellt, wird target_polycount ignoriert.
Verfügbare Werte:
- 1: Adaptiv — ultra Polycount.
- 2: Adaptiv — hohe Polycount.
- 3: Adaptiv — mittlere Polycount.
- 4: Adaptiv — niedrige Polycount.
Name
save_pre_remeshed_model
Type
boolean
Standard false
Description
Wenn auf true gesetzt, speichert Meshy zusätzlich eine GLB-Datei, bevor die Neuvernetzung abgeschlossen ist.

Name
symmetry_mode
Type
string
⚠ veraltet
Standard auto
Description
Veraltet. Dieser Parameter beeinflusst nicht mehr die Ausgabe.
Das Feld symmetry_mode steuert das Symmetrieverhalten während des Modellgenerierungsprozesses.
Die gültigen Werte sind:
- off: Deaktiviert die Symmetrie.
- auto: Bestimmt und wendet Symmetrie automatisch basierend auf der Eingabegeometrie an.
- on: Erzwingt Symmetrie während der Generierung.
Name
pose_mode
Type
string
Standard ""
Description
Gibt den Pose-Modus für das generierte Modell an.
Verfügbare Werte:
- a-pose: Erzeuge das Modell in einer A-Pose.
- t-pose: Erzeuge das Modell in einer T-Pose.
- "" (leere Zeichenkette): Es wird keine spezifische Pose angewendet.
Name
is_a_t_pose
Type
boolean
⚠ veraltet
Standard false
Description
Verwenden Sie pose_mode stattdessen. Bestimmt, ob das Modell in einer A-/T-Pose erzeugt wird.
Name
image_enhancement
Type
boolean
Standard true
Description
Optimiert die Eingabebilder für bessere Ergebnisse. Auf false setzen, um das genaue Aussehen der Eingabebilder ohne Stilbearbeitung beizubehalten.
Nur unterstützt, wenn ai_model meshy-6, meshy-7 oder latest ist.
Name
remove_lighting
Type
boolean
Standard true
Description
Entfernt Highlights und Schatten von der Basisfarbtextur, was ein saubereres Ergebnis erzeugt, das besser unter benutzerdefinierten Beleuchtungssetups funktioniert.
Nur unterstützt, wenn ai_model meshy-6, meshy-7 oder latest ist.
Name
moderation
Type
boolean
Standard false
Description
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.
Jedes Bild aus image_urls und der Text aus texture_prompt werden überprüft.
Name
target_formats
Type
string[]
Description
Gibt an, welche 3D-Dateiformate in die Ausgabe aufgenommen werden sollen. Nur die angeforderten Formate werden generiert und zurückgegeben, was die Aufgabenerledigungszeit verkürzen kann.
Verfügbare Werte: glb, obj, fbx, stl, usdz, 3mf
Wenn weggelassen, werden alle Formate außer 3mf generiert. 3mf wird nur dann eingeschlossen, wenn es ausdrücklich angegeben wird.
Name
auto_size
Type
boolean
Standard false
Description
Wenn auf true gesetzt, verwendet der Dienst KI-Vision, um automatisch die reale Höhe des Objekts zu schätzen und das Modell entsprechend zu skalieren. Der Ursprung wird standardmäßig auf bottom gesetzt, es sei denn, origin_at wird ausdrücklich festgelegt.
Name
alpha_thumbnail
Type
boolean
Standard false
Description
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 thumbnail_url-Feld bleibt unverändert.
Name
multi_view_thumbnails
Type
boolean
Standard false
Description
Wenn auf true gesetzt, rendert die Aufgabe zusätzlich vier kardinale Ansicht-Miniaturen (vorne, rechts, hinten, links) und gibt sie unter thumbnail_urls in der GET-Antwort zurück. Das bestehende thumbnail_url-Feld bleibt unverändert und zeigt weiterhin auf die Vorderansicht, sodass bestehende Clients nicht betroffen sind.
Fügt ca. 3 Sekunden zur Aufgabenlatenz hinzu.

Gilt nur wenn auto_size = true

Name
origin_at
Type
string
Standard bottom
Description
Position des Ursprungs, wenn auto_size aktiviert ist. Verfügbare Werte: bottom, center.

Rückgabewerte

Die result-Eigenschaft der Antwort enthält die Aufgaben-id der neu erstellten Multi-Bild zu 3D-Aufgabe.

Fehlermodi

Name
400 - Bad Request
Description
Die Anfrage war nicht akzeptabel. Häufige Ursachen:
- Fehlender Parameter: Entweder image_urls oder input_task_id muss angegeben werden.
- Ungültige Eingabeaufgabe: Die input_task_id muss auf eine SUCCEEDED Text zu Bild, Bild zu Bild oder Mehransicht-Variante-Aufgabe verweisen.
- Ungültige Bildanzahl: image_urls muss zwischen 1 und 4 Bilder enthalten.
- Ungültiges Bildformat: Eines oder mehrere der Bilder in image_urls sind nicht unterstützte Formate.
- Nicht erreichbare URL: Eine oder mehrere image_urls konnten nicht heruntergeladen werden.
Name
401 - Unauthorized
Description
Authentifizierung fehlgeschlagen. Bitte überprüfen Sie Ihren API-Schlüssel.
Name
402 - Payment Required
Description
Unzureichende Credits, um diese Aufgabe auszuführen.
Name
429 - Too Many Requests
Description
Sie haben Ihre Ratenbegrenzung überschritten.

Anfrage

POST

/openapi/v1/multi-image-to-3d

# Eine einfache Anfrage
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# Mit PBR-Texturierung und GLB-Format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

Response

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

GET/openapi/v1/multi-image-to-3d/:id

Rufe eine Multi-Bild zu 3D Aufgabe ab

Dieser Endpunkt ermöglicht es Ihnen, eine Multi-Bild zu 3D-Aufgabe mit einer gültigen Aufgaben-id abzurufen. Siehe Das Multi-Bild zu 3D Aufgabenobjekt, um zu sehen, welche Eigenschaften im Multi-Bild zu 3D Aufgabenobjekt enthalten sind.

Parameter

Name
id
Type
path
Description
Eindeutiger Bezeichner für die abzurufende Multi-Bild zu 3D-Aufgabe.

Rückgabewerte

Die Antwort enthält das Multi-Bild zu 3D Aufgabenobjekt. Prüfen Sie den Abschnitt Das Multi-Bild zu 3D Aufgabenobjekt für Details.

Anfrage

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "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=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

DELETE/openapi/v1/multi-image-to-3d/:id

Lösche eine Multi-Bild zu 3D Aufgabe

Dieser Endpunkt löscht dauerhaft eine Multi-Bild zu 3D-Aufgabe, einschließlich aller zugehörigen Modelle und Daten. Diese Aktion ist irreversibel.

Pfadparameter

Name
id
Type
path
Description
Die ID der zu löschenden Multi-Bild zu 3D-Aufgabe.

Rückgabewerte

Gibt 200 OK bei Erfolg zurück.

Anfrage

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Gibt 200 OK bei Erfolg zurück.

GET/openapi/v1/multi-image-to-3d

Liste Multi-Bild zu 3D Aufgaben

Dieser Endpunkt ermöglicht es Ihnen, eine Liste von Multi-Bild zu 3D-Aufgaben abzurufen.

Parameter

Optionale Attribute

Name
page_num
Type
integer
Description
Seitennummer für die Paginierung. Beginnt und ist standardmäßig 1.
Name
page_size
Type
integer
Description
Seitenlimit. Standardmäßig 10 Elemente. Maximal erlaubt sind 50 Elemente.
Name
sort_by
Type
string
Description
Feld, nach dem sortiert werden soll. Verfügbare Werte:
- +created_at: Sortiere nach Erstellungszeit in aufsteigender Reihenfolge.
- -created_at: Sortiere nach Erstellungszeit in absteigender Reihenfolge.

Rückgabewerte

Gibt eine paginierte Liste der Das Multi-Bild zu 3D Aufgabenobjekte zurück.

Anfrage

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "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=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "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",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

GET/openapi/v1/multi-image-to-3d/:id/stream

Streame eine Multi-Bild zu 3D Aufgabe

Dieser Endpunkt streamt Echtzeit-Updates für eine Multi-Bild zu 3D Aufgabe mit Server-Sent Events (SSE).

Parameter

Name
id
Type
path
Description
Eindeutiger Bezeichner für die zu streamende Multi-Bild zu 3D Aufgabe.

Rückgabewerte

Gibt einen Strom von Das Multi-Bild zu 3D Aufgabenobjekte als Server-Sent Events zurück.

Für PENDING oder IN_PROGRESS Aufgaben enthält der Antwort-Stream nur die erforderlichen progress und status Felder.

Anfrage

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Fehler-Event-Beispiel
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Nachrichten-Event-Beispiele illustrieren Aufgabenfortschritt.
// Für PENDING oder IN_PROGRESS Aufgaben enthält der Antwort-Stream nicht alle Felder.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "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=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

Das Multi-Bild zu 3D Aufgabenobjekt

Das Multi-Bild zu 3D Aufgabenobjekt ist eine Arbeitseinheit, die Meshy verfolgt, um ein 3D-Modell aus mehreren Bildern (zwischen 1 bis 4 inklusive) zu generieren. Die Bilder sollten dasselbe Objekt darstellen, idealerweise aus verschiedenen Ansichten oder Winkeln. Das Objekt hat die folgenden Eigenschaften:

Eigenschaften

Name
id
Type
string
Description
Eindeutiger Bezeichner für die Aufgabe. Während wir eine k-sortable UUID für Aufgaben-IDs als Implementierungsdetail verwenden, sollten Sie keine Annahmen über das Format der ID machen.
Name
type
Type
string
Description
Typ der Multi-Bild zu 3D Aufgabe. Der Wert ist multi-image-to-3d.
Name
model_urls
Type
object
Description
Downloadbare URL zur texturierten 3D-Modell-Datei, die von Meshy generiert wurde. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht generiert wird, anstatt einen leeren String zurückzugeben.
- Name
  glb
  Type
  string
  Description
  Downloadbare URL zur GLB-Datei.
- Name
  fbx
  Type
  string
  Description
  Downloadbare URL zur FBX-Datei.
- Name
  obj
  Type
  string
  Description
  Downloadbare URL zur OBJ-Datei.
- Name
  usdz
  Type
  string
  Description
  Downloadbare URL zur USDZ-Datei.
- Name
  mtl
  Type
  string
  Description
  Downloadbare URL zur MTL-Datei, zurückgegeben zusammen mit OBJ-Exporten, wenn Texturen vorhanden sind.
- Name
  stl
  Type
  string
  Description
  Downloadbare URL zur STL-Datei.
- Name
  3mf
  Type
  string
  Description
  Downloadbare URL zur 3MF-Datei. Nur vorhanden, wenn 3mf über target_formats angefordert wurde.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  Downloadbare URL zur ursprünglichen GLB-Ausgabe vor der Neuvernetzung.
  Nur verfügbar, wenn die Aufgabe mit beiden should_remesh: true und save_pre_remeshed_model: true erstellt wurde.
Name
thumbnail_url
Type
string
Description
Downloadbare URL zum Miniaturbild der Modelldatei. Entspricht thumbnail_urls.front, wenn vorhanden, aus Kompatibilitätsgründen beibehalten.
Name
alpha_thumbnail_url
Type
string
Description
Downloadbare URL zu einer Version von thumbnail_url mit transparentem Hintergrund (RGBA). Ist nur vorhanden, wenn die Aufgabe mit alpha_thumbnail: true erstellt wurde und die transparente Vorschau erfolgreich gerendert wurde, andernfalls wird dieses Feld weggelassen.
Name
thumbnail_urls
Type
object
Description
Downloadbare URLs für vier kardinale Ansicht-Miniaturen des generierten 3D-Modells. Jeder Wert ist eine signierte URL zu einem 512×512 PNG, das mit denselben Materialien und derselben Beleuchtung wie thumbnail_url gerendert wird. Nützlich, um das Modell aus mehreren Winkeln in Batch-Pipelines anzuzeigen, ohne den GLB herunterzuladen.
Nur vorhanden, wenn die Aufgabe mit multi_view_thumbnails: true erstellt wurde und SUCCEEDED erreicht hat. Ältere Aufgaben und Aufgaben, die ohne das Opt-in erstellt wurden, enthalten dieses Feld nicht.
- Name
  front
  Type
  string
  Description
  Vorderansicht, 0° Drehung um die vertikale Achse (entspricht thumbnail_url).
- Name
  right
  Type
  string
  Description
  Rechte Ansicht, 90° Drehung.
- Name
  back
  Type
  string
  Description
  Rückansicht, 180° Drehung.
- Name
  left
  Type
  string
  Description
  Linke Ansicht, 270° Drehung.
Name
texture_prompt
Type
string
Description
Das Text-prompt, das verwendet wurde, um den Texturierungsprozess zu leiten.
Name
progress
Type
integer
Description
Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet ist, ist diese Eigenschaft 0. Sobald die Aufgabe erfolgreich war, wird dies 100 sein.
Name
started_at
Type
timestamp
Description
Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht gestartet ist, ist diese Eigenschaft 0.
Ein Zeitstempel stellt die Anzahl der Millisekunden dar, die seit dem 1. Januar 1970 UTC verstrichen sind, gemäß dem RFC 3339 Standard. Zum Beispiel wird Freitag, 1. September 2023 12:00:00 PM GMT als 1693569600000 dargestellt. Dies gilt für alle Zeitstempel in der Meshy API.
Name
created_at
Type
timestamp
Description
Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.
Name
expires_at
Type
timestamp
Description
Zeitstempel, wann das Aufgabenergebnis abläuft, in Millisekunden.
Name
finished_at
Type
timestamp
Description
Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden. Wenn die Aufgabe noch nicht abgeschlossen ist, ist diese Eigenschaft 0.
Name
status
Type
string
Description
Status der Aufgabe. Mögliche Werte sind eine von PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
Ein Array von Textur-URL-Objekten, die aus der Aufgabe generiert wurden. Normalerweise enthält dieses nur ein Textur-URL-Objekt. Jede Textur-URL hat die folgenden Eigenschaften:
- Name
  base_color
  Type
  string
  Description
  Downloadbare URL zum Basisfarb-Map-Bild.
- Name
  metallic
  Type
  string
  Description
  Downloadbare URL zum metallischen Map-Bild.
  Wenn die Aufgabe mit enable_pbr: false erstellt wurde, wird diese Eigenschaft weggelassen.
- Name
  normal
  Type
  string
  Description
  Downloadbare URL zur Normal Map Bilddatei.
  Wenn die Aufgabe mit enable_pbr: false erstellt wurde, wird diese Eigenschaft weggelassen.
- Name
  roughness
  Type
  string
  Description
  Downloadbare URL zur Rauheit-Map Bilddatei.
  Wenn die Aufgabe mit enable_pbr: false erstellt wurde, wird diese Eigenschaft weggelassen.
- Name
  emission
  Type
  string
  Description
  Downloadbare URL zur Emissions-Map Bilddatei.
  Wenn die Aufgabe mit enable_pbr: false erstellt wurde oder ai_model meshy-5 ist, wird diese Eigenschaft weggelassen.
Name
preceding_tasks
Type
integer
Description
Die Anzahl der vorangegangenen Aufgaben.
Der Wert dieses Feldes ist nur dann sinnvoll, wenn der Aufgabenstatus PENDING ist.
Name
task_error
Type
object
Description
Fehlerdetails für fehlgeschlagene Aufgaben. Siehe Fehler für die vollständige task_error Objektreferenz.
Name
consumed_credits
Type
integer
Description
Die Anzahl der in 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 Fehler erstattet).

Beispiel Multi-Bild zu 3D Aufgabenobjekt

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "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=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30,
}