lowpoly wird am 30.10.2026 abgeschaltet. meshy-7 wird als 3D-Generierungsmodell am 31.12.2026 abgeschaltet; als Texturmodell bleibt es verfügbar. Wechseln Sie vor diesen Terminen das Modell, um Fehler bei Anfragen zu vermeiden. Alle Abkündigungen ansehen

Rigging API

Fügen Sie einem humanoiden oder vierbeinigen 3D-Modell ein Skelett (Armature) hinzu und binden Sie das Netz daran, sodass der Charakter für die Animation bereit ist. Informationen zum Anwenden von Animationen auf einen geriggten Charakter finden Sie in der Animation API.

Rigging funktioniert gut mit standardmäßigen humanoiden (zweibeinigen) Charakteren, die eine klar definierte Gliedmaßen- und Körperstruktur haben, sowie mit vierbeinigen Tieren. Informationen zum Riggen eines Tieres finden Sie unter Ein vierbeiniges Tier riggen.


POST/openapi/v1/rigging

Eine Rigging-Aufgabe erstellen

Erstellt eine Rigging-Aufgabe für ein 3D-Modell. Wenn die Aufgabe erfolgreich ist, liefert sie einen gerigten Charakter in Standardformaten und optional einfache Geh- und Lauf-Animationen.

Die Aufgabe läuft im Hintergrund. Wie lange eine Aufgabe normalerweise dauert, erfahren Sie unter Verarbeitungszeiten.

Rigging ist für diese Modelle nicht geeignet:

  • Netze ohne Textur
  • Assets, die weder humanoide noch vierbeinige Tiere sind
  • Humanoide Assets mit unklarer Gliedmaßen- und Körperstruktur

Request

POST
/openapi/v1/rigging
# Rig a model from a URL
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "height_meters": 1.8
  }'

Response

{
  "result": "018b314a-a1b5-716d-c222-2f1776f7f579"
}

Parameter

  • Name
    input_task_id
    Type
    string
    Erforderlich
    Description

    Erforderlich, sofern Sie nicht model_url senden. Die ID der Aufgabe, deren Modell Sie riggen möchten. Meshy unterstützt texturierte humanoide Modelle und vierbeinige Tiere.

    Das Modell darf höchstens 380.000 Dreiecke haben (ein Viereck zählt als 2), ein Modell mit mehr liefert 400. Um unter dem Limit zu bleiben, führen Sie zuerst die Remesh-API mit einem target_polycount von höchstens 300000 darauf aus, oder höchstens 150000 mit topology: quad.

  • Name
    model_url
    Type
    string
    Erforderlich
    Description

    Erforderlich, sofern Sie nicht input_task_id senden. Das zu riggende Modell, als öffentliche URL oder als Data URI. Wenn Sie beides senden, verwendet Meshy input_task_id.

    Das Modell muss eine GLB-Datei (.glb) mit höchstens 400 MB von einer http- oder https-URL sein, oder 100 MB als Data URI. Rigging unterstützt texturierte humanoide Modelle und vierbeinige Tiere.

    Das Modell darf höchstens 380.000 Dreiecke haben (ein Viereck zählt als 2), ein Modell mit mehr liefert 400. Um unter dem Limit zu bleiben, führen Sie zuerst die Remesh-API mit einem target_polycount von höchstens 300000 darauf aus, oder höchstens 150000 mit topology: quad.

    Das Gesicht des Charakters muss zur +Z-Achse zeigen, der Standard-Vorwärtsrichtung von glTF. Die Posenschätzung schlägt fehl, wenn ein Modell in eine andere Achse zeigt.

    Eine Datei über 100 MB muss zusätzlich diese Regeln erfüllen:

    • Sie darf höchstens 10.000.000 Flächen haben. Eine Datei mit mehr liefert 400. Meshy zählt Flächen als Dreiecke, und ein mehrfach gezeichnetes Netz zählt einmal pro Kopie.
    • Sie darf keine Draco-Komprimierung verwenden.
  • Name
    animation_type
    Type
    string
    Standard biped
    Description

    Die Art des zu riggenden Charakters. Jeder andere Wert liefert 400.

    Verfügbare Werte:

  • Name
    height_meters
    Type
    number
    Standard 1.7 (biped)
    Description

    Die Höhe des Modells in Metern. Meshy skaliert das gerigte Modell auf diese Höhe. Ein negativer Wert liefert 400.

    • Biped-Rig: Standardwert 1.7.
    • Quadruped-Rig: ohne Angabe oder mit 0 behält das Tier seine eigene Größe.
  • Name
    texture_image_url
    Type
    string
    ⚠ veraltet
    Description

    Lassen Sie dies weg, wenn das Modell eigene Texturen besitzt. Ohne diesen Parameter verwendet Meshy die in der model_url-Datei eingebetteten Texturen oder die Texturen der Eingabeaufgabe. Wenn Sie ihn senden, wird dieses Bild zur einzigen Textur des gerigten Modells, und das Modell verliert seine PBR-Texturen.

    Die UV-entfaltete Basisfarbtextur des Modells, als öffentliche URL oder als Data URI. Das Bild muss eine PNG-Datei mit höchstens 20 MB sein. Ein anderes Bildformat liefert 400.

  • Name
    skeleton_template
    Type
    string
    Standard meshyrig
    Description

    Das Skelett für den gerigten Charakter, das dessen Knochennamen und Hierarchie festlegt. Wählen Sie das Skelett, das Ihre Engine oder Ihr Tool erwartet.

    Verfügbare Werte:

    • meshyrig: Meshys eigenes Skelett
    • mixamo: Mixamo
    • ue5_mannequin: Unreal Engine 5 Mannequin
    • max_biped: 3ds Max Biped
    • unity_humanoid: Unity Humanoid
    • maya_human_ik: Maya HumanIK
    • blender_rigify_basic_human: Blender Rigify basic human
    • cc5_hd_neutral_base: Character Creator 5 HD neutral base
    • daz_genesis9: DAZ Genesis 9

    Jeder andere Wert liefert 400. Funktioniert nur mit einem Biped-Rig.

    Mit einem anderen Wert als meshyrig oder mit include_fingers auf true gesetzt, liegen die Dateien in Metern vor und verwenden die Knochen dieses Skeletts, statt der standardmäßigen 24-Knochen-meshyrig-Dateien in Zentimetern. Bei einem Modell, das Meshy auf diesem Skelett nicht riggen kann, schlägt die Aufgabe fehl. Versuchen Sie es erneut mit meshyrig und include_fingers auf false gesetzt, oder mit einem anderen Wert.

    Die Animationsclips in der Bibliothek dieser Dateien tragen dieselben Namen wie in den Standard-meshyrig-Dateien, zum Beispiel Armature|walking_man|baselayer. Ein Text-to-Motion-Clip heißt bei jedem Rig retarget_clip. Die FBX-Datei enthält Endknochen. Einige Endknochen, wie headfront, behalten ihre ursprünglichen Namen.

    Animation-Aufgaben, die aus diesem Rig erstellt werden, verwenden dasselbe Skelett.

  • Name
    include_fingers
    Type
    boolean
    Standard false
    Description

    Ob den Händen des Charakters Fingerknochen hinzugefügt werden sollen. Funktioniert nur mit einem Biped-Rig. Bei meshyrig verwenden die Fingerknochen Mixamo-Namen, zum Beispiel LeftHandThumb1.

    Mit true liefern diese Anfragen einen Fehler, und Meshy berechnet dafür keine Kosten:

    • Ein Quadruped-Rig, texture_image_url, oder eine input_task_id, deren Modell eine Quad-Topologie hat, liefert 400.
    • Ein Modell, das Meshy nur ohne Fingerknochen riggen kann, liefert 422.
    • Falls Meshy die Hände des Charakters nicht mit Fingern riggen kann, schlägt die Aufgabe fehl. Versuchen Sie es erneut, oder setzen Sie include_fingers auf false.

    Meshy findet die Finger automatisch und funktioniert am besten bei Händen mit klar getrennten Fingern. Bei Händen, die als eine Form modelliert sind, etwa Fäustlinge, Handschuhe oder stilisierte Hände, kann das Rig weniger Fingerknochen haben und die Hand als ein einziges Teil animieren. Der Rest des Skeletts bleibt in beiden Fällen gleich. Das Skelett kann auch zusätzliche Knochen enthalten, zum Beispiel für Haare oder Kleidung. Fingerknochen ändern die Credit-Kosten nicht.

Rückgabe

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

Fehlermodi

  • Name
    400 - Bad Request
    Description

    Die Anfrage kann nicht ausgeführt werden. Die Fehlermeldung nennt das gefundene Problem. Zum Beispiel:

    • Fehlender Parameter: Weder model_url noch input_task_id wurde gesendet.
    • Ungültiges Modellformat: Die model_url-Datei hat eine nicht unterstützte Erweiterung. Nur .glb wird unterstützt.
    • Nicht erreichbare URL: Meshy kann die model_url-Datei nicht herunterladen.
    • Modelldatei zu groß: Die model_url-Datei ist über 400 MB groß, wenn sie von einer http- oder https-URL stammt, 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.
    • Nicht lesbare Modelldatei: Die model_url-Datei ist über 100 MB groß, und Meshy kann ihren Header nicht lesen. Zum Beispiel ist sie eine Draco-komprimierte GLB-Datei.
    • Modell-Header zu komplex: Die model_url-Datei ist über 100 MB groß, und ihr Header hat zu viele Meshes, Nodes 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 texture_image_url-Bild ist über 20 MB groß.
    • Ungültiges Texturformat: Das texture_image_url-Bild ist keine PNG-Datei.
    • Ungültige Höhe: height_meters ist negativ.
    • Ungültige Skelettvorlage: skeleton_template ist keiner der verfügbaren Werte, oder wurde mit einem Quadruped-Rig gesendet.
    • Fingerknochen nicht unterstützt: include_fingers ist true bei einem Quadruped-Rig, texture_image_url, oder einer input_task_id, deren Modell eine Quad-Topologie hat.
    • Ungültige Eingabeaufgabe: input_task_id verweist nicht auf eine gültige API-Aufgabe.
    • Eingabeaufgabe nicht bereit: Die Aufgabe input_task_id hat SUCCEEDED noch nicht erreicht. Warten Sie, bis sie erfolgreich ist, und versuchen Sie es erneut.
    • Flächenanzahl überschritten: Das Eingabemodell hat mehr als 380.000 Dreiecke (ein Viereck zählt als 2). Führen Sie die Remesh-API mit einem target_polycount von höchstens 300000 darauf aus, oder höchstens 150000 mit topology: quad, bevor Sie das Modell riggen.

    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 genug Credits für diese Aufgabe, oder das Konto hat ein Credit-Limit erreicht. Prü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 Abonnementeinstellungen und versuchen Sie es erneut.
  • Name
    403 - Forbidden
    Description

    input_task_id ist ein Flachrelief-Modell, das dieser Endpunkt nicht riggen kann. Die Meldung lautet This model type does not support this operation. Senden Sie ein anderes Modell.

  • Name
    404 - Not Found
    Description

    Meshy kann die Dateien der input_task_id-Aufgabe nicht finden. Einer dieser Fälle trifft zu:

    • Meshy hat die Dateien der Aufgabe nach ihrem expires_at gelöscht. Erstellen Sie die Aufgabe erneut und senden Sie die ID dieser Aufgabe.
    • Die Aufgabe hat keine der für das Rigging benötigten Dateien, wie etwa ein Vorschaubild, zum Beispiel eine Convert-Aufgabe. Riggen Sie die Aufgabe, aus der sie stammt, oder senden Sie das Modell als model_url.
  • Name
    422 - Unprocessable Entity
    Description

    Zum Beispiel:

    • Posenschätzung fehlgeschlagen: Das Modell ist möglicherweise kein gültiger humanoider Charakter. Senden Sie ein Modell eines humanoiden Charakters. Prüfen Sie bei model_url auch, ob der Charakter zur +Z-Achse ausgerichtet ist.
    • Skelettvorlage nicht verfügbar: Meshy kann dieses Modell nur auf dem Skelett meshyrig riggen. Lassen Sie skeleton_template weg, oder setzen Sie es auf meshyrig. Meshy berechnet für diese Anfrage keine Kosten.
    • Fingerknochen nicht verfügbar: Meshy kann dieses Modell nur auf meshyrig ohne Fingerknochen riggen. Lassen Sie include_fingers und skeleton_template weg. Meshy berechnet für diese Anfrage keine Kosten.
  • Name
    429 - Too Many Requests
    Description

    Sie haben Ihre Ratenbegrenzung überschritten. Warten Sie und versuchen Sie es dann erneut. Siehe Ratenbegrenzungen.

  • Name
    503 - Service Unavailable
    Description

    Meshy konnte die Analyse der Pose des Modells nicht abschließen. Wiederholen Sie die Anfrage.


Ein vierbeiniges Tier riggen

Um ein vierbeiniges Tier zu riggen, sende animation_type auf quadruped gesetzt.

Ein Vierbeiner-Rig unterscheidet sich in folgenden Punkten von einem Zweibeiner-Rig:

  • basic_animations enthält eine Lauf- und eine Renn-Animation des Tieres. Wenn Meshy eine davon nicht erstellen kann, sind deren URLs leere Zeichenketten, und die Aufgabe gilt trotzdem als erfolgreich. walking_armature_glb_url und running_armature_glb_url sind das Skelett des Rigs, ohne Animation.
  • height_meters hat standardmäßig nicht den Wert 1.7. Siehe Eine Rigging-Aufgabe erstellen.
  • Wird skeleton_template gesendet, oder include_fingers auf true gesetzt, wird 400 zurückgegeben.
  • Wenn Meshy das Modell nicht als vierbeiniges Tier riggen kann, schlägt die Aufgabe fehl.

Ein Vierbeiner-Rig kostet genauso viel wie ein Zweibeiner-Rig. Siehe Preise.

Um das geriggte Tier zu animieren, wende Bibliotheksanimationen an, deren rig_type den Wert quadruped hat, als action_id oder action_ids. Siehe Animation.

Request

POST
/openapi/v1/rigging
# Rig a four-legged animal
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "animation_type": "quadruped"
  }'

GET/openapi/v1/rigging/:id

Rigging-Task abrufen

Gibt einen Rigging-Task anhand seiner ID zurück.

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}

Parameter

  • Name
    id
    Type
    path
    Description

    Die Task-ID aus der Erstellungsantwort.

Rückgabe

Das Rigging-Task-Objekt.


DELETE/openapi/v1/rigging/:id

Rigging-Task löschen

Löscht einen Rigging-Task dauerhaft, einschließlich seiner Modelle und Daten. Das Löschen kann nicht rückgängig gemacht werden.

Request

DELETE
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -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 des zu löschenden Tasks.

Task-Status

Das Löschen eines PENDING-Tasks erstattet die Credits, die bei seiner Erstellung verwendet wurden.

Ein IN_PROGRESS-Task kann nicht gelöscht werden. Die Anfrage liefert 409 Conflict, und der Task läuft weiter. Meshy erstattet keine Credits für einen bereits gestarteten Task, weshalb ein Löschen Sie sowohl die Credits als auch das Ergebnis kosten würde. Warten Sie, bis er den Status SUCCEEDED, FAILED oder CANCELED erreicht, und löschen Sie ihn dann.

Das Löschen eines Tasks in einem finalen Status (SUCCEEDED, FAILED oder CANCELED) erstattet dessen Credits nicht.

Rückgabe

200 OK, wenn der Task gelöscht wurde, oder 409 Conflict, wenn der Task IN_PROGRESS ist.


GET/openapi/v1/rigging

Rigging-Aufgaben auflisten

Gibt eine paginierte Liste deiner Rigging-Aufgaben zurück, die neuesten zuerst. Um durch die Liste zu blättern, verwende page_num und page_size.

Aufgaben, die du über die API erstellst, bleiben in der API und erscheinen nicht unter My Assets in der Web-App. Um eine Aufgabe zu finden, deren ID dir nicht mehr vorliegt, verwende diesen Endpunkt.

Request

GET
/openapi/v1/rigging
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

GET/openapi/v1/rigging/:id/stream

Einen Rigging-Task streamen

Streamt die Updates eines Rigging-Tasks als Server-Sent Events (SSE).

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream
curl -N https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/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": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: { // Example of a SUCCEEDED task event, with the same fields as the Rigging task object
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/.../Character_output.fbx?...",
    "rigged_character_glb_url": "https://assets.meshy.ai/.../Character_output.glb?...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.glb?...",
      "walking_fbx_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.fbx?...",
      "walking_armature_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin_armature.glb?...",
      "running_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.glb?...",
      "running_fbx_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.fbx?...",
      "running_armature_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin_armature.glb?..."
    }
  }
}

Parameter

  • Name
    id
    Type
    path
    Description

    Die Task-ID aus der Erstellungsantwort.

Rückgabe

Ein Stream von Rigging-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 Rigging-Task-Objekt

Ein Rigging-Task-Objekt beschreibt das Rigging eines Charakters. Es enthält den Status, den progress und die Ausgabedateien, wenn die Aufgabe erfolgreich abgeschlossen wird.

Eigenschaften

Example Rigging Task Object

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}
  • Name
    id
    Type
    string
    Description

    Die Task-ID. Behandeln Sie sie als eine undurchsichtige Zeichenfolge und verlassen Sie sich nicht auf ihr Format.

  • Name
    type
    Type
    string
    Description

    Der Task-Typ, immer rig.

  • Name
    status
    Type
    string
    Description

    Der Task-Status, einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED oder CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Wie viel von der Aufgabe erledigt ist, als Prozentsatz. Der Wert ist 0, bis die Aufgabe beginnt, und 100, wenn sie erfolgreich abgeschlossen wird.

  • Name
    created_at
    Type
    timestamp
    Description

    Zeitpunkt der Erstellung der Aufgabe, in Unix-Millisekunden.

  • Name
    started_at
    Type
    timestamp
    Description

    Zeitpunkt des Starts der Aufgabe, in Unix-Millisekunden. Der Wert ist 0, bis die Aufgabe startet.

  • Name
    finished_at
    Type
    timestamp
    Description

    Zeitpunkt des Abschlusses der Aufgabe, in Unix-Millisekunden. Der Wert ist 0, bis die Aufgabe abgeschlossen ist.

  • Name
    expires_at
    Type
    timestamp
    Description

    Zeitpunkt, zu dem die Ergebnisdateien der Aufgabe ablaufen, in Unix-Millisekunden. Nach diesem Zeitpunkt kann Meshy die Dateien löschen.

  • Name
    task_error
    Type
    object
    Description

    Die Fehlerdetails, wenn die Aufgabe fehlschlägt. Der Wert ist null, außer wenn der Status FAILED ist. Siehe Fehler.

  • Name
    consumed_credits
    Type
    integer
    Description

    Die Anzahl der von der Aufgabe verbrauchten Credits. Vorhanden, wenn der Status PENDING, IN_PROGRESS oder SUCCEEDED ist. Bei einer FAILED-Aufgabe ist der Wert 0, da Meshy die Credits erstattet, wenn eine Aufgabe fehlschlägt.

  • Name
    result
    Type
    object
    Description

    Die URLs der Ausgabedateien. Bis die Aufgabe erfolgreich abgeschlossen ist, ist jede URL eine leere Zeichenfolge, und basic_animations ist null.

    • Name
      rigged_character_fbx_url
      Type
      string
      Description

      Download-URL für den geriggten Charakter als FBX-Datei.

    • Name
      rigged_character_glb_url
      Type
      string
      Description

      Download-URL für den geriggten Charakter als GLB-Datei.

    • Name
      basic_animations
      Type
      object (optional)
      Description

      Download-URLs für die standardmäßigen Geh- und Laufanimationen.

      • Name
        walking_glb_url
        Type
        string
        Description
        Die Gehanimation mit Skin, als GLB-Datei.
      • Name
        walking_fbx_url
        Type
        string
        Description
        Die Gehanimation mit Skin, als FBX-Datei.
      • Name
        walking_armature_glb_url
        Type
        string
        Description
        Die Armature der Gehanimation, als GLB-Datei.
      • Name
        running_glb_url
        Type
        string
        Description
        Die Laufanimation mit Skin, als GLB-Datei.
      • Name
        running_fbx_url
        Type
        string
        Description
        Die Laufanimation mit Skin, als FBX-Datei.
      • Name
        running_armature_glb_url
        Type
        string
        Description
        Die Armature der Laufanimation, als GLB-Datei.
  • Name
    preceding_tasks
    Type
    integer
    Description

    Die Anzahl der Aufgaben, die in der Warteschlange vor dieser Aufgabe stehen. Der Wert ist nur aussagekräftig, solange die Aufgabe PENDING ist. Das Feld wird weggelassen, wenn der Wert 0 ist.