Rigging API
Fügen Sie einem humanoiden 3D-Modell ein Skelett (Armature) hinzu und binden Sie das Netz daran, sodass der Charakter animationsbereit ist. Um Animationen auf einen geriggten Charakter anzuwenden, siehe die Animation API.
Rigging funktioniert nur gut mit standardmäßigen humanoiden (zweibeinigen) Charakteren, die eine klar definierte Gliedmaßen- und Körperstruktur haben.
Rigging-Task erstellen
Erstellt einen Rigging-Task für ein 3D-Modell. Wenn der Task erfolgreich ist, gibt er einen gerigten Charakter in Standardformaten zurück und optional grundlegende Geh- und Lauf-Animationen.
Der Task läuft im Hintergrund. Wie lange ein Task normalerweise dauert, erfahren Sie unter Verarbeitungszeiten.
Rigging ist für diese Modelle nicht geeignet:
- Netze ohne Textur
- Nicht-humanoide Assets
- 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 des Tasks, dessen Modell Sie riggen möchten. Meshy unterstützt texturierte humanoide Modelle.Das Modell darf höchstens 380.000 Dreiecke haben (ein Viereck zählt als 2), und ein Modell mit mehr gibt
400zurück. Um unter dem Limit zu bleiben, führen Sie zunächst die Remesh-API mit einemtarget_polycountvon300000oder weniger aus, oder150000oder weniger mittopology: 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) von höchstens 400 MB über einehttp- oderhttps-URL sein, oder 100 MB als Data URI. Rigging unterstützt texturierte humanoide Modelle.Das Modell darf höchstens 380.000 Dreiecke haben (ein Viereck zählt als 2), und ein Modell mit mehr gibt
400zurück. Um unter dem Limit zu bleiben, führen Sie zunächst die Remesh-API mit einemtarget_polycountvon300000oder weniger aus, oder150000oder weniger mittopology: quad.Das Gesicht des Charakters muss zur +Z-Achse zeigen, der Standard-Vorwärtsrichtung von glTF. Bei einem Modell, das zu einer anderen Achse zeigt, schlägt die Posenschätzung fehl.
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 gibt
400zurück. 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 gibt
- Name
- height_meters
- Type
- number
- Standard 1.7
- Description
Die ungefähre Körpergröße des Charakters, in Metern. Meshy nutzt diesen Wert, um das Modell genauer zu skalieren und zu riggen. Ein negativer Wert gibt
400zurück.
- Name
- texture_image_url
- Type
- string
- ⚠ veraltet
- Description
Lassen Sie diesen Parameter weg, wenn das Modell eigene Texturen hat. Ohne ihn verwendet Meshy die in der
model_url-Datei eingebetteten Texturen oder die Texturen des Eingabe-Tasks. 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 von höchstens 20 MB sein. Ein anderes Bildformat gibt
400zurück.
- Name
- skeleton_template
- Type
- string
- Standard meshyrig
- Description
Das Skelett für den gerigten Charakter, das seine 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 gibt
400zurück. Funktioniert nur mit einem zweibeinigen Rig.Mit einem anderen Wert als
meshyrig, oder wenninclude_fingersauftruegesetzt ist, liegen die Dateien in Metern vor und verwenden die Knochen dieses Skeletts, statt der standardmäßigenmeshyrig-Dateien mit 24 Knochen in Zentimetern. Ein Modell, das Meshy mit diesem Skelett nicht riggen kann, lässt den Task fehlschlagen. Versuchen Sie es erneut mitmeshyrigundinclude_fingersauffalse, oder mit einem anderen Wert.Die Animationsclips in diesen Dateien tragen dieselben Namen wie in den standardmäßigen
meshyrig-Dateien, zum BeispielArmature|walking_man|baselayer. Die FBX-Datei enthält Endknochen. Einige Endknochen, wieheadfront, behalten ihre ursprünglichen Namen.Animation-Tasks, 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 zweibeinigen Rig. Bei
meshyrigverwenden die Fingerknochen Mixamo-Namen, zum BeispielLeftHandThumb1.Bei
truegeben diese Anfragen einen Fehler zurück, und Meshy berechnet dafür keine Credits:- Ein vierbeiniges Rig,
texture_image_urloder eininput_task_id, dessen Modell eine Quad-Topologie hat, gibt400zurück. - Ein Modell, das Meshy nur ohne Fingerknochen riggen kann, gibt
422zurück. - Wenn Meshy die Hände des Charakters nicht mit Fingern riggen kann, schlägt der Task 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 einzige Form modelliert sind, wie 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 vierbeiniges Rig,
Rückgabewerte
Das Feld result der Antwort enthält die ID des neuen Rigging-Tasks.
Fehlermodi
- 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_urlnochinput_task_idwurde gesendet. - Ungültiges Modellformat: Die
model_url-Datei hat eine nicht unterstützte Dateierweiterung. Nur.glbwird unterstützt. - Nicht erreichbare URL: Meshy kann die
model_url-Datei nicht herunterladen. - Modell-Datei zu groß: Die
model_url-Datei ist über 400 MB groß über einehttp- oderhttps-URL, 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 Modell-Datei: Die
model_url-Datei ist über 100 MB groß, und Meshy kann deren Header nicht lesen. Zum Beispiel handelt es sich um eine Draco-komprimierte GLB-Datei. - Modell-Header zu komplex: Die
model_url-Datei ist über 100 MB groß, und ihr Header enthält zu viele Netze, Knoten oder Einträge zum Prüfen. 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 vierbeinigen Rig gesendet. - Fingerknochen nicht unterstützt:
include_fingersisttruezusammen mit einem vierbeinigen Rig,texture_image_urloder eineminput_task_id, dessen Modell eine Quad-Topologie hat. - Ungültiger Eingabe-Task:
input_task_idverweist nicht auf einen gültigen API-Task. - Eingabe-Task nicht bereit: Der Task zu
input_task_idhatSUCCEEDEDnoch nicht erreicht. Warten Sie, bis er erfolgreich ist, und versuchen Sie es dann 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_polycountvon300000oder weniger aus, oder150000oder weniger mittopology: 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 genügend Credits für diesen Task, oder das Konto hat ein Credit-Limit erreicht. Überprüfen Sie Ihr Credit-Guthaben und versuchen Sie es dann erneut.
- Kostenloser Plan: Das Erstellen eines Tasks erfordert einen kostenpflichtigen Plan. Aktualisieren Sie Ihren Plan in Ihren Abonnement-Einstellungen und versuchen Sie es dann erneut.
- Name
403 - Forbidden- Description
input_task_idist ein Relief-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 des Tasks zu
input_task_idnicht finden. Einer dieser Fälle trifft zu:- Meshy hat die Dateien des Tasks nach dessen
expires_atgelöscht. Erstellen Sie den Task erneut und senden Sie dann die ID dieses Tasks. - Der Task hat keine der Dateien, die für Rigging benötigt werden, wie z. B. ein Vorschaubild, zum Beispiel ein Convert-Task. Riggen Sie den Task, aus dem er stammt, oder senden Sie das Modell als
model_url.
- Meshy hat die Dateien des Tasks nach dessen
- 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_urlzusätzlich, ob der Charakter zur +Z-Achse zeigt. - Skelettvorlage nicht verfügbar: Meshy kann dieses Modell nur mit dem
meshyrig-Skelett riggen. Lassen Sieskeleton_templateweg, oder setzen Sie es aufmeshyrig. Meshy berechnet keine Kosten für diese Anfrage. - Fingerknochen nicht verfügbar: Meshy kann dieses Modell nur mit
meshyrigohne Fingerknochen riggen. Lassen Sieinclude_fingersundskeleton_templateweg. Meshy berechnet keine Kosten für diese Anfrage.
- 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. Versuchen Sie die Anfrage erneut.
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.