Resize-API

Die Resize-API ermöglicht es Ihnen, bestehende 3D-Modelle auf reale Dimensionen zu Größe ändern. Sie können eine genaue Höhe angeben, eine Einschränkung der längsten Seite festlegen oder die KI automatisch die passende Größe schätzen lassen.

POST/openapi/v1/resize

Erstellen einer Resize-Aufgabe

Dieser Endpunkt erstellt eine neue Resize-Aufgabe.

Parameter

Nur einer von input_task_id oder model_url ist erforderlich. Wenn beide angegeben sind, hat input_task_id Priorität.

Name
input_task_id
Type
string
Erforderlich
Description
Die ID einer abgeschlossenen Meshy-Aufgabe, deren Modell Sie ändern möchten. Die Aufgabe muss den Status SUCCEEDED haben. Das Ausgabeformat wird GLB sein.

Name
model_url
Type
string
Erforderlich
Description
Eine öffentlich zugängliche URL oder Data URI, die auf eine 3D-Modell-Datei verweist. Unterstützte Formate: .glb, .gltf, .obj, .fbx, .stl. Für Data URIs verwenden Sie den MIME-Typ: application/octet-stream. Das Ausgabeformat wird das ursprüngliche Format des Eingabemodells beibehalten.

Genau ein Resize-Modus ist erforderlich: resize_height, resize_longest_side oder auto_size. Diese drei Parameter schließen sich gegenseitig aus.

Name
resize_height
Type
number
Description
Ändern Sie die Größe des Modells auf eine bestimmte Höhe, gemessen in Metern.

Name
resize_longest_side
Type
number
Description
Ändern Sie die Größe des Modells so, dass seine längste Seite diesem Wert entspricht, gemessen in Metern. Das Seitenverhältnis bleibt erhalten.

Name
auto_size
Type
boolean
Description
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 bottom gesetzt, es sei denn, origin_at wird explizit festgelegt.

Name
origin_at
Type
string
Standard bottom
Description
Position des Ursprungs nach der Größenänderung.
Verfügbare Werte: bottom, center.

Rückgaben

Die result-Eigenschaft der Antwort enthält die id der neu erstellten Resize-Aufgabe.

Fehlermodi

400 - Bad Request

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

Fehlender Parameter: Entweder model_url oder input_task_id muss angegeben werden.
Fehlender Resize-Modus: Mindestens einer von resize_height, resize_longest_side oder auto_size muss angegeben werden.
Gegenseitig ausschließende Parameter: resize_height, resize_longest_side und auto_size können nicht kombiniert werden.
Ungültige Eingabeaufgabe: Die input_task_id muss sich auf eine erfolgreiche Aufgabe beziehen.
Ungültiges Modellformat: Die model_url verweist auf eine Datei mit einer nicht unterstützten Erweiterung.
Nicht erreichbare URL: Die model_url konnte nicht heruntergeladen werden.

401 - Unauthorized

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

402 - Payment Required

Unzureichende Credits, um diese Aufgabe auszuführen.

429 - Too Many Requests

Sie haben Ihre Ratenbegrenzung überschritten.

Anfrage

POST

/openapi/v1/resize

# Simple: resize to a specific height
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "resize_height": 1.8
  }'

# Advanced: resize longest side with custom origin
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb",
    "resize_longest_side": 2.0,
    "origin_at": "center"
  }'

Antwort

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

GET/openapi/v1/resize/:id

Abrufen einer Größenänderungsaufgabe

Dieser Endpunkt ruft eine Größenänderungsaufgabe anhand ihrer ID ab.

Parameter

Name
id
Type
path
Description
Die ID der abzurufenden Größenänderungsaufgabe.

Rückgaben

Das Resize Task-Objekt.

Anfrage

GET

/openapi/v1/resize/:id

curl https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Antwort

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

DELETE/openapi/v1/resize/:id

Löschen einer Aufgabe zur Größenänderung

Dieser Endpunkt löscht dauerhaft eine Aufgabe zur Größenänderung, einschließlich aller zugehörigen Modelle und Daten. Diese Aktion ist unwiderruflich.

Pfadparameter

Name
id
Type
path
Description
Die ID der zu löschenden Aufgabe zur Größenänderung.

Rückgaben

Gibt 200 OK bei Erfolg zurück.

Anfrage

DELETE

/openapi/v1/resize/:id

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Antwort

// Returns 200 Ok on success.

GET/openapi/v1/resize

Liste der Größe-ändern-Aufgaben

Dieser Endpunkt ermöglicht es Ihnen, eine Liste von Größe-ändern-Aufgaben abzurufen.

Parameter

Name
page_num
Type
integer
Standard 1
Description
Seitennummer für die Paginierung.

Name
page_size
Type
integer
Standard 10
Description
Seitengrößenlimit. Maximal erlaubt sind 50 Elemente.

Name
sort_by
Type
string
Description
Feld zum Sortieren. Verfügbare Werte:
- +created_at: Sortieren nach Erstellungszeit in aufsteigender Reihenfolge.
- -created_at: Sortieren nach Erstellungszeit in absteigender Reihenfolge.

Rückgaben

Gibt eine paginierte Liste der Die Größe-ändern-Aufgaben-Objekte zurück.

Anfrage

GET

/openapi/v1/resize

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

Antwort

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "resize",
    "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "task_error": null,
    "consumed_credits": 1
  }
]

GET/openapi/v1/resize/:id/stream

Streamen einer Größenänderungsaufgabe

Dieser Endpunkt streamt Echtzeit-Updates für eine Größenänderungsaufgabe unter Verwendung von Server-Sent Events (SSE).

Parameter

Name
id
Type
path
Description
Eindeutiger Bezeichner für die zu streamende Größenänderungsaufgabe.

Rückgaben

Gibt einen Stream von The Resize Task Objects als Server-Sent Events zurück.

Für PENDING oder IN_PROGRESS Aufgaben enthält der Antwortstream nur die notwendigen progress und status Felder.

Anfrage

GET

/openapi/v1/resize/:id/stream

curl -N https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Antwortstream

// Message event examples illustrate task progress.
event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

Das Resize-Task-Objekt

Das Resize-Task-Objekt repräsentiert einen Größenänderungsauftrag.

Eigenschaften

id · string

Eindeutiger Bezeichner für den Task.

type · string

Typ des Tasks. Der Wert ist resize.

model_urls · object

Herunterladbare URL für die Datei des geänderten Modells. Bei Verwendung von input_task_id ist die Ausgabe immer GLB. Bei Verwendung von model_url bleibt das ursprüngliche Format erhalten.

progress · integer

Fortschritt des Tasks (0-100).

status · string

Status des Tasks. Mögliche Werte: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

preceding_tasks · integer

Die Anzahl der vorhergehenden Tasks. Nur relevant, wenn der Status PENDING ist.

created_at · timestamp

Zeitstempel, wann der Task erstellt wurde, in Millisekunden.

started_at · timestamp

Zeitstempel, wann der Task gestartet wurde, in Millisekunden. 0, wenn nicht gestartet.

finished_at · timestamp

Zeitstempel, wann der Task abgeschlossen wurde, in Millisekunden. 0, wenn nicht abgeschlossen.

task_error · object

Fehlerobjekt, wenn der Task fehlgeschlagen ist. Siehe Fehler für weitere Details.

consumed_credits · integer

Die Anzahl der von diesem Task verbrauchten Credits (1 Credit pro Größenänderungsauftrag). Gibt 0 für FAILED Tasks zurück.