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.
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
# 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_urlsenden. 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 einemtarget_polycountvon höchstens300000darauf aus, oder höchstens150000mittopology: quad.
- Name
- model_url
- Type
- string
- Erforderlich
- Description
Erforderlich, sofern Sie nicht
input_task_idsenden. Das zu riggende Modell, als öffentliche URL oder als Data URI. Wenn Sie beides senden, verwendet Meshyinput_task_id.Das Modell muss eine GLB-Datei (
.glb) mit höchstens 400 MB von einerhttp- oderhttps-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 einemtarget_polycountvon höchstens300000darauf aus, oder höchstens150000mittopology: 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.
- Sie darf höchstens 10.000.000 Flächen haben. Eine Datei mit mehr liefert
- Name
- animation_type
- Type
- string
- Standard biped
- Description
Die Art des zu riggenden Charakters. Jeder andere Wert liefert
400.Verfügbare Werte:
biped: ein humanoider Charakterquadruped: ein vierbeiniges Tier. Siehe Ein vierbeiniges Tier riggen.
- 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
0behält das Tier seine eigene Größe.
- Biped-Rig: Standardwert
- 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 Skelettmixamo: Mixamoue5_mannequin: Unreal Engine 5 Mannequinmax_biped: 3ds Max Bipedunity_humanoid: Unity Humanoidmaya_human_ik: Maya HumanIKblender_rigify_basic_human: Blender Rigify basic humancc5_hd_neutral_base: Character Creator 5 HD neutral basedaz_genesis9: DAZ Genesis 9
Jeder andere Wert liefert
400. Funktioniert nur mit einem Biped-Rig.Mit einem anderen Wert als
meshyrigoder mitinclude_fingersauftruegesetzt, 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 mitmeshyrigundinclude_fingersauffalsegesetzt, oder mit einem anderen Wert.Die Animationsclips in der Bibliothek dieser Dateien tragen dieselben Namen wie in den Standard-
meshyrig-Dateien, zum BeispielArmature|walking_man|baselayer. Ein Text-to-Motion-Clip heißt bei jedem Rigretarget_clip. Die FBX-Datei enthält Endknochen. Einige Endknochen, wieheadfront, 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
meshyrigverwenden die Fingerknochen Mixamo-Namen, zum BeispielLeftHandThumb1.Mit
trueliefern diese Anfragen einen Fehler, und Meshy berechnet dafür keine Kosten:- Ein Quadruped-Rig,
texture_image_url, oder eineinput_task_id, deren Modell eine Quad-Topologie hat, liefert400. - 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_fingersauffalse.
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.
- Ein Quadruped-Rig,
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_urlnochinput_task_idwurde gesendet. - Ungültiges Modellformat: Die
model_url-Datei hat eine nicht unterstützte Erweiterung. Nur.glbwird 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 einerhttp- oderhttps-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_metersist negativ. - Ungültige Skelettvorlage:
skeleton_templateist keiner der verfügbaren Werte, oder wurde mit einem Quadruped-Rig gesendet. - Fingerknochen nicht unterstützt:
include_fingersisttruebei einem Quadruped-Rig,texture_image_url, oder einerinput_task_id, deren Modell eine Quad-Topologie hat. - Ungültige Eingabeaufgabe:
input_task_idverweist nicht auf eine gültige API-Aufgabe. - Eingabeaufgabe nicht bereit: Die Aufgabe
input_task_idhatSUCCEEDEDnoch 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_polycountvon höchstens300000darauf aus, oder höchstens150000mittopology: quad, bevor Sie das Modell riggen.
Korrigieren 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 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_idist ein Flachrelief-Modell, das dieser Endpunkt nicht riggen kann. Die Meldung lautetThis 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_atgelö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.
- Meshy hat die Dateien der Aufgabe nach ihrem
- 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_urlauch, ob der Charakter zur +Z-Achse ausgerichtet ist. - Skelettvorlage nicht verfügbar: Meshy kann dieses Modell nur auf dem Skelett
meshyrigriggen. Lassen Sieskeleton_templateweg, oder setzen Sie es aufmeshyrig. Meshy berechnet für diese Anfrage keine Kosten. - Fingerknochen nicht verfügbar: Meshy kann dieses Modell nur auf
meshyrigohne Fingerknochen riggen. Lassen Sieinclude_fingersundskeleton_templateweg. Meshy berechnet für diese Anfrage keine Kosten.
- Posenschätzung fehlgeschlagen: Das Modell ist möglicherweise kein gültiger humanoider Charakter. Senden Sie ein Modell eines humanoiden Charakters. Prüfen Sie bei
- 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_animationsenthä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_urlundrunning_armature_glb_urlsind das Skelett des Rigs, ohne Animation.height_metershat standardmäßig nicht den Wert1.7. Siehe Eine Rigging-Aufgabe erstellen.- Wird
skeleton_templategesendet, oderinclude_fingersauftruegesetzt, wird400zurü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
# 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"
}'
Rigging-Task abrufen
Gibt einen Rigging-Task anhand seiner ID zurück.
Request
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.
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
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.
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
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Einen Rigging-Task streamen
Streamt die Updates eines Rigging-Tasks als Server-Sent Events (SSE).
Request
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,FAILEDoderCANCELED.
- Name
- progress
- Type
- integer
- Description
Wie viel von der Aufgabe erledigt ist, als Prozentsatz. Der Wert ist
0, bis die Aufgabe beginnt, und100, 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 StatusFAILEDist. Siehe Fehler.
- Name
- consumed_credits
- Type
- integer
- Description
Die Anzahl der von der Aufgabe verbrauchten Credits. Vorhanden, wenn der Status
PENDING,IN_PROGRESSoderSUCCEEDEDist. Bei einerFAILED-Aufgabe ist der Wert0, 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_animationsistnull.- 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
PENDINGist. Das Feld wird weggelassen, wenn der Wert0ist.