Creative Lab Vinyl Figure API

Verwandeln Sie ein Foto in zwei Schritten in eine Vinyl-Sammelfigur mit großem Kopf als 3D-Figur. Ein Prototyp-Task erzeugt aus dem Foto ein Konzeptbild. Ein Build-Task verwandelt dieses Bild in ein texturiertes 3D-Modell und verwendet die ID des Prototyp-Tasks als input_task_id.

POST /openapi/creative-lab/vinyl-figure/v1/prototype
POST /openapi/creative-lab/vinyl-figure/v1/build

POST/openapi/creative-lab/vinyl-figure/v1/prototype

Erstellen einer Vinyl Figure-Prototyp-Aufgabe

Erzeugt aus einem Foto ein Konzeptbild im Vinyl-Figure-Stil. Um das 3D-Modell zu erstellen, übergeben Sie die ID dieser Aufgabe als input_task_id an den Build-Endpunkt. Die Felder der Aufgabe finden Sie unter Das Vinyl Figure-Prototyp-Aufgabenobjekt.

Request

POST

/openapi/creative-lab/vinyl-figure/v1/prototype

# Stage 1: generate a vinyl-figure-style concept image
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

{
  "result": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}

Prototyp-Beispiel

Beginnen Sie mit einem Ausgangsfoto und erzeugen Sie anschließend das Prototypbild, das für die Build-Stufe verwendet wird.

Ausgangsfoto, das als Eingabe für die Creative Lab Vinyl Figure verwendet wird — Prototyp-Eingabe

Aus dem Ausgangsfoto erzeugtes Big-Head-Vinyl-Figur-Prototypbild — Prototyp-Ausgabe

Parameter

Name
image_url
Type
string
Erforderlich
Description
Das Foto, das in eine Big-Head-Vinyl-Figur umgewandelt werden soll, als öffentliche URL oder als Data URI (data:image/jpeg;base64,<Ihre base64-codierten Bilddaten>).
Das Bild muss eine JPG-, JPEG-, PNG- oder WebP-Datei von höchstens 20 MB sein.
Name
name
Type
string
Description
Ein Name für die Aufgabe, bis zu 100 Zeichen. Er wird im Feld name der Aufgabe zurückgegeben. Ein längerer Name führt zu 400.
Name
remove_background
Type
boolean
Standard false
Description
Gibt an, ob der Hintergrund aus dem Prototypbild entfernt werden soll. true liefert ein transparentes RGBA-PNG, sodass Sie das Motiv auf jeden beliebigen Hintergrund setzen können. Auch der Build-Vorgang startet dann vom Bild ohne Hintergrund. Falls Meshy den Hintergrund nicht entfernen kann, wird das Bild mit Hintergrund zurückgegeben, und die Aufgabe gilt trotzdem als erfolgreich.

Rückgabewerte

Das Feld result enthält die ID der neuen Prototyp-Aufgabe. Rufen Sie die Aufgabe ab oder streamen Sie sie, bis status den Wert SUCCEEDED hat. Übergeben Sie die ID dann als input_task_id an den Build-Endpunkt.

Fehlerfälle

Name
400 - Bad Request
Description
Die Anfrage kann nicht ausgeführt werden. Zum Beispiel:
- image_url fehlt.
- Das Bild ist keine JPG-, JPEG-, PNG- oder WebP-Datei.
- Das Bild ist zu klein, größer als 20 MB oder überschreitet die maximale Pixelanzahl.
- Meshy kann das Bild nicht herunterladen, zum Beispiel weil die URL 404 zurückgibt oder ein Timeout auftritt.
- Die Data URI ist kein gültiges base64.
- Das Bild wurde als NSFW eingestuft.
Die Fehlermeldung nennt das gefundene Problem. Beheben Sie die Anfrage und senden Sie sie erneut.
Name
401 - Unauthorized
Description
Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den Header Authorization.
Name
402 - Payment Required
Description
Einer der folgenden Fälle trifft zu:
- Das Konto verfügt nicht über ausreichend Credits.
- Der API-Schlüssel, der Arbeitsbereich oder das Mitglied hat sein Credit-Limit erreicht.
- Das Konto befindet sich im kostenlosen Plan.
Überprüfen Sie Ihre Credits und Ihren Plan und versuchen Sie es erneut.
Name
403 - Forbidden
Description
Ihr Team hat die IP-Filterung aktiviert, und Meshy hat das Bild wegen geistigen Eigentums Dritter markiert. Senden Sie ein Bild, zu dessen Nutzung Sie berechtigt sind.
Name
429 - Too Many Requests
Description
Eine der folgenden Grenzen wurde erreicht:
- Sie haben mehr Anfragen gesendet, als Ihre Ratenbegrenzung erlaubt. Warten Sie einige Sekunden und versuchen Sie es erneut. Siehe Ratenbegrenzungen.
- Zu viele Ihrer Aufgaben sind in der Warteschlange oder laufen bereits. Warten Sie, bis einige abgeschlossen sind, und versuchen Sie es erneut.
- Bei einem unbegrenzten Plan ohne verbleibende Credits haben Sie die Anzahl der Aufgaben erreicht, die ohne Credits laufen können. Warten Sie, bis eine Aufgabe abgeschlossen ist, oder fügen Sie Credits hinzu.
Name
500 - Internal Server Error
Description
Bei Meshy ist ein Serverfehler aufgetreten, zum Beispiel weil die Prüfung auf geistiges Eigentum für das Bild nicht ausgeführt werden konnte. Meshy erstellt die Aufgabe nicht und erstattet alle dafür berechneten Credits zurück. Senden Sie die Anfrage erneut.

POST/openapi/creative-lab/vinyl-figure/v1/build

Erstellen einer Vinyl Figure-Build-Aufgabe

Generiert die texturierte 3D-Vinyl-Figur aus einer erfolgreich abgeschlossenen Prototyp-Aufgabe. Die zugehörigen Felder finden Sie unter Das Vinyl Figure-Build-Aufgabenobjekt.

Request

POST

/openapi/creative-lab/vinyl-figure/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}

Parameter

Name
input_task_id
Type
string
Erforderlich
Description
Die ID der zu erstellenden Prototyp-Aufgabe. Es muss sich um eine Aufgabe handeln, die Ihr Konto mit POST /openapi/creative-lab/vinyl-figure/v1/prototype erstellt hat und deren Status SUCCEEDED lautet.
Eine ID, die keiner Ihrer Vinyl Figure-Prototyp-Aufgaben aus der API entspricht, führt zu 404, einschließlich eines in der Web-App erstellten Prototyps.
Name
name
Type
string
Description
Ein Name für die Aufgabe mit bis zu 100 Zeichen. Er wird im Feld name der Aufgabe zurückgegeben. Ein längerer Name führt zu 400.

Rückgabewerte

Das Feld result enthält die ID der neuen Build-Aufgabe. Rufen Sie die Aufgabe ab oder streamen Sie sie, bis status den Wert SUCCEEDED hat. Laden Sie anschließend das texturierte GLB über model_urls.glb herunter. Für ein OBJ laden Sie stattdessen model_urls.obj zusammen mit der zugehörigen Materialdatei über model_urls.mtl herunter.

Fehlermodi

Name
400 - Bad Request
Description
Die Anfrage kann nicht ausgeführt werden. Zum Beispiel:
- input_task_id fehlt oder ist keine gültige Aufgaben-ID.
- Der Status der Prototyp-Aufgabe ist nicht SUCCEEDED. Falls sie noch läuft, warten Sie und versuchen Sie es erneut. Falls sie fehlgeschlagen oder abgebrochen wurde, erstellen Sie eine neue Prototyp-Aufgabe.
- Die Prototyp-Aufgabe war erfolgreich, hat aber kein Bild. Erstellen Sie eine neue Prototyp-Aufgabe.
Die Fehlermeldung gibt an, welches Problem gefunden wurde.
Name
401 - Unauthorized
Description
Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den Authorization-Header.
Name
402 - Payment Required
Description
Einer der folgenden Fälle trifft zu:
- Das Konto verfügt nicht über genügend Credits.
- Der API-Schlüssel, der Arbeitsbereich oder das Mitglied hat das Credit-Limit erreicht.
- Das Konto nutzt den kostenlosen Plan.
Überprüfen Sie Ihre Credits und Ihren Plan und versuchen Sie es erneut.
Name
404 - Not Found
Description
input_task_id entspricht keiner Vinyl Figure-Prototyp-Aufgabe, die Ihr Konto über die API erstellt hat. Ein in der Web-App erstellter Prototyp führt ebenfalls zu 404. Senden Sie die result-ID aus einer Prototyp-Erstellungsantwort.
Name
429 - Too Many Requests
Description
Eines dieser Limits wurde erreicht:
- Sie haben mehr Anfragen gesendet, als Ihre Ratenbegrenzung erlaubt. Warten Sie einige Sekunden und versuchen Sie es erneut. Siehe Ratenbegrenzungen.
- Zu viele Ihrer Aufgaben befinden sich in der Warteschlange oder laufen bereits. Warten Sie, bis einige abgeschlossen sind, und versuchen Sie es erneut.
- Bei einem unbegrenzten Plan ohne verbleibende Credits haben Sie die Anzahl der Aufgaben erreicht, die ohne Credits ausgeführt werden können. Warten Sie, bis eine Aufgabe abgeschlossen ist, oder fügen Sie Credits hinzu.

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Einen Vinyl-Figure-Task abrufen

Gibt einen Prototype- oder Build-Task zurück. Der Pfad muss zur Stage des Tasks passen. Ein über /prototype/:id angeforderter Build-Task liefert 404, und ebenso liefert ein über /build/:id angeforderter Prototype-Task 404.

Die Felder finden Sie unter Das Vinyl-Figure-Prototype-Task-Objekt und Das Vinyl-Figure-Build-Task-Objekt.

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

Parameter

Name
id
Type
path
Description
Die Task-ID aus der Create-Antwort.

Rückgabe

Das Prototype-Task-Objekt oder das Build-Task-Objekt, passend zur Stage im Pfad.

Fehlermodi

Name
400 - Bad Request
Description
id ist keine gültige Task-ID. Senden Sie die result-ID aus der Create-Antwort.
Name
403 - Forbidden
Description
Ihr Team hat IP Filtering aktiviert, und Meshy hat das Bild des Tasks wegen geistigen Eigentums Dritter markiert. Teams im Enterprise-Plan erhalten diesen Fehler nicht. Erstellen Sie einen Prototype-Task aus einem Bild, an dem Sie die Nutzungsrechte besitzen.
Name
404 - Not Found
Description
Es gehört kein Vinyl-Figure-Task mit dieser ID zu Ihrem Konto, oder die Stage des Tasks stimmt nicht mit dem Pfad überein. Überprüfen Sie die ID und verwenden Sie /prototype oder /build passend zum Task.
Name
500 - Internal Server Error
Description
Meshy konnte die Prüfung auf geistiges Eigentum nicht ausführen. Wiederholen Sie die Anfrage.

DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Eine Vinyl-Figur-Aufgabe löschen

Bricht eine Vinyl-Figur-Aufgabe ab. Das Abbrechen einer Aufgabe mit Status PENDING erstattet deren Credits. Eine Aufgabe mit Status IN_PROGRESS wird ohne Erstattung abgebrochen, da bereits ein Worker mit der Bearbeitung begonnen hat. Eine Aufgabe mit einem endgültigen Status (SUCCEEDED, FAILED oder CANCELED) kann nicht abgebrochen werden.

Der Pfad muss zur Phase der Aufgabe passen. Zum Beispiel gibt DELETE auf /prototype/:id mit der ID einer Build-Aufgabe 404 zurück.

Request

DELETE

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

Pfadparameter

Name
id
Type
path
Description
Die ID der abzubrechenden Aufgabe.

Rückgabewerte

204 No Content mit leerem Body.

Fehlermodi

Name
400 - Bad Request
Description
Einer der folgenden Fälle trifft zu:
- id ist keine gültige Aufgaben-ID. Senden Sie die result-ID aus der Erstellungsantwort.
- Die Aufgabe hat bereits einen endgültigen Status (SUCCEEDED, FAILED oder CANCELED) und kann daher nicht abgebrochen werden.
Name
404 - Not Found
Description
Es gehört keine Vinyl-Figur-Aufgabe mit dieser ID zu Ihrem Konto, oder die Phase der Aufgabe stimmt nicht mit dem Pfad überein. Überprüfen Sie die ID und verwenden Sie /prototype oder /build, um die Aufgabe korrekt zuzuordnen.

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

Einen Vinyl Figure-Task streamen

Streamt die Updates eines Vinyl Figure-Tasks als Server-Sent Events (SSE). Der Pfad muss der Phase des Tasks entsprechen. Falls nicht – zum Beispiel die ID eines Build-Tasks unter /prototype/:id/stream – sendet der Stream ein einzelnes error-Event mit status_code: 404 und wird geschlossen.

Request

GET

/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream

curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is shortened to the fields that change.
event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

Parameter

Name
id
Type
path
Description
Die Task-ID aus der Create-Antwort.

Rückgabe

Ein Stream von prototype- oder build-Task-Objekten. Jedes Event enthält das vollständige Task-Objekt, so wie es Einen Vinyl Figure-Task abrufen zurückgibt. Solange der Task PENDING oder IN_PROGRESS ist, sind seine Ausgabefelder noch leer (null, [] oder {}), und finished_at ist null.

Falls die IP-Filterung das Ergebnis des Tasks blockiert, sendet der Stream stattdessen ein einzelnes error-Event mit dem status_code, den eine Get-Anfrage zurückgeben würde.

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

Vinyl-Figur-Aufgaben auflisten

Gibt Ihre Vinyl-Figur-Aufgaben einer Stufe aus, jeweils eine Seite auf einmal. Der Pfad legt die Stufe fest. /prototype liefert nur Prototyp-Aufgaben, und /build liefert nur Build-Aufgaben.

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Pfadparameter

Name
stage
Type
path
Erforderlich
Description
Die aufzulistende Stufe, prototype oder build.

Abfrageparameter

Name
page_num
Type
integer
Standard 1
Description
Die zurückzugebende Seite, von 1 bis 255. 0 gibt die erste Seite zurück. Ein Wert außerhalb von 0 bis 255 liefert 400.
Name
page_size
Type
integer
Standard 10
Description
Anzahl der Aufgaben pro Seite, bis zu 100. Ein Wert von 101 bis 255 liefert 100 Aufgaben, und 0 verwendet den Standardwert. Ein Wert außerhalb von 0 bis 255 liefert 400.
Name
sort_by
Type
string
Standard -created_at
Description
Die Sortierreihenfolge.
Verfügbare Werte:
- -created_at: neueste zuerst
- +created_at: älteste zuerst

Rückgabewerte

Ein Array von Prototyp-Aufgabenobjekten oder Build-Aufgabenobjekten, entsprechend der Stufe im Pfad.

Das Vinyl Figure Prototype-Task-Objekt

Ein Prototype-Task erzeugt aus einem Foto ein Konzeptbild im Vinyl-Figuren-Stil. Um das Bild in ein 3D-Modell umzuwandeln, übergeben Sie die ID des Tasks als input_task_id an den Build-Endpunkt.

Eigenschaften

Example Vinyl Figure Prototype Task Object

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Name
id
Type
string
Description
Die Task-ID. Verlassen Sie sich nicht auf ihr Format.
Name
type
Type
string
Description
Der Task-Typ, immer creative-lab-vinyl-figure-prototype.
Name
name
Type
string
Description
Der name, den Sie beim Erstellen des Tasks angegeben haben, oder "", wenn Sie keinen angegeben haben.
Name
status
Type
string
Description
Der Status des Tasks.
Verfügbare Werte:
- PENDING: wartet in der Warteschlange
- IN_PROGRESS: generiert das Ergebnis
- SUCCEEDED: final, mit dem Ergebnis
- FAILED: final, mit dem Grund in task_error
- CANCELED: final, ohne Ergebnis
Name
progress
Type
integer
Description
Prozentsatz der erledigten Arbeit, von 0 bis 100. Er ist 0, bis der Task beginnt, und 100, wenn er erfolgreich ist.
Name
created_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task erstellt wurde, in Unix-Millisekunden.
Name
started_at
Type
timestamp
Description
Zeitpunkt, zu dem ein Worker den Task gestartet hat, in Unix-Millisekunden. Bis dahin null.
Name
finished_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task einen finalen Status erreicht hat, in Unix-Millisekunden. Bis dahin null.
Name
expires_at
Type
timestamp
Description
Zeitpunkt, zu dem das Ergebnis des Tasks abläuft, in Unix-Millisekunden. Das sind 3 Tage nach finished_at, oder bis der Task abgeschlossen ist 3 Tage nach created_at. Bei Enterprise-Konten, die API-Ergebnisse unbegrenzt aufbewahren, liegt er etwa 100 Jahre später. Siehe Aufbewahrung von Assets.
Name
preceding_tasks
Type
integer
Description
Die Position des Tasks in der Warteschlange, solange er PENDING ist. 1 bedeutet, dass er als Nächstes startet. 0, nachdem der Task die Warteschlange verlassen hat, und immer 0 in Listenergebnissen.
Name
task_error
Type
object
Description
Grund, warum der Task fehlgeschlagen ist. null, außer wenn status den Wert FAILED hat. Siehe Fehler.
Name
consumed_credits
Type
integer
Description
Anzahl der für den Task berechneten Credits, nach einer eventuellen Rückerstattung. Eine Anfrage, die einen Fehler zurückgibt, wird nicht berechnet. Bei einem fehlgeschlagenen Task ist der Wert 0, da Meshy ihn erstattet. Ein Abbruch erstattet einen Task nur, solange er PENDING ist. Wenn Meshy die Belastung nicht auslesen kann, lässt eine Get- oder Stream-Antwort das Feld weg, und eine Listenanfrage liefert 500. Wiederholen Sie in diesem Fall die Anfrage.
Name
image_urls
Type
array of strings
Description
Download-URLs für das Konzeptbild. Das Array enthält eine URL, nachdem der Task erfolgreich war, und ist bis dahin leer.

Das Vinyl Figure Build-Task-Objekt

Ein Build-Task generiert eine texturierte 3D-Vinylfigur aus einem erfolgreichen Prototype-Task. Die Felder model_urls, thumbnail_url und texture_urls haben das gleiche Format wie im Bild zu 3D Task-Objekt.

Eigenschaften

Example Vinyl Figure Build Task Object

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

Name
id
Type
string
Description
Die Task-ID. Verlassen Sie sich nicht auf ihr Format.
Name
type
Type
string
Description
Der Task-Typ, immer creative-lab-vinyl-figure-build.
Name
name
Type
string
Description
Der name, den Sie beim Erstellen des Tasks gesendet haben, oder "", wenn Sie keinen gesendet haben.
Name
status
Type
string
Description
Der Status des Tasks.
Verfügbare Werte:
- PENDING: wartet in der Warteschlange
- IN_PROGRESS: Ergebnis wird generiert
- SUCCEEDED: final, mit dem Ergebnis
- FAILED: final, mit dem Grund in task_error
- CANCELED: final, ohne Ergebnis
Name
progress
Type
integer
Description
Prozentsatz der erledigten Arbeit, von 0 bis 100. Er ist 0, bis der Task beginnt, und 100, wenn er erfolgreich abgeschlossen wird.
Name
created_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task erstellt wurde, in Unix-Millisekunden.
Name
started_at
Type
timestamp
Description
Zeitpunkt, zu dem ein Worker den Task gestartet hat, in Unix-Millisekunden. Bis dahin null.
Name
finished_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task einen finalen Status erreicht hat, in Unix-Millisekunden. Bis dahin null.
Name
expires_at
Type
timestamp
Description
Zeitpunkt, zu dem das Ergebnis des Tasks abläuft, in Unix-Millisekunden. Das ist 3 Tage nach finished_at, oder 3 Tage nach created_at, solange der Task noch nicht abgeschlossen ist. Bei Enterprise-Konten, die API-Ergebnisse unbegrenzt aufbewahren, liegt er etwa 100 Jahre später. Siehe Aufbewahrung von Assets.
Name
preceding_tasks
Type
integer
Description
Die Position des Tasks in der Warteschlange, solange er PENDING ist. 1 bedeutet, dass er als Nächstes startet. 0, nachdem der Task die Warteschlange verlassen hat, und immer 0 in Listenergebnissen.
Name
task_error
Type
object
Description
Warum der Task fehlgeschlagen ist. null, es sei denn, status ist FAILED. Siehe Fehler.
Name
consumed_credits
Type
integer
Description
Anzahl der für den Task berechneten Credits, nach einer eventuellen Rückerstattung. Eine Anfrage, die einen Fehler zurückgibt, wird nicht berechnet. Bei einem fehlgeschlagenen Task ist der Wert 0, da Meshy ihn erstattet. Ein Abbruch erstattet einen Task nur, solange er PENDING ist. Wenn Meshy die Belastung nicht auslesen kann, lässt eine get- oder stream-Antwort das Feld weg, und eine Listenanfrage gibt 500 zurück. Wiederholen Sie in diesem Fall die Anfrage.
Name
prompt
Type
string
Description
Immer "" für einen Vinyl Figure Build-Task.
Name
negative_prompt
Type
string
Description
Immer "" für einen Vinyl Figure Build-Task, wie prompt.
Name
texture_prompt
Type
string
Description
Immer "" für einen Vinyl Figure Build-Task, wie prompt.
Name
texture_image_url
Type
string
Description
Immer "" für einen Vinyl Figure Build-Task, wie prompt.
Name
model_urls
Type
object
Description
Download-URLs für das 3D-Modell, als texturiertes GLB und als OBJ-Datei mit zugehöriger MTL-Datei.
- Name
  glb
  Type
  string
  Description
  Download-URL für die texturierte GLB-Datei.
- Name
  obj
  Type
  string
  Description
  Download-URL für die OBJ-Datei, mit der Geometrie und den UVs.
- Name
  mtl
  Type
  string
  Description
  Download-URL für die MTL-Materialdatei, die zu obj gehört. Verwenden Sie sie zusammen mit obj und der Textur in texture_urls[0].base_color.
Name
thumbnail_url
Type
string
Description
Download-URL für ein Vorschaubild des Modells.
Name
texture_urls
Type
array
Description
Die Texturen, als Array mit einem Objekt, das die Basisfarbkarte enthält.
- Name
  base_color
  Type
  string
  Description
  Download-URL für die Basisfarbkarte.