Creative Lab — Brick Figur API

Verwandeln Sie ein Ausgangsfoto in zwei Phasen in eine sammelbare 3D-Miniaturfigur im Brick-Stil: Prototyp erzeugt ein stilisiertes Konzeptbild aus Ihrem Eingabefoto, dann Bau verwandelt dieses Konzeptbild in ein texturiertes 3D-Modell. Die beiden Phasen sind über input_task_id verbunden.

  • POST /openapi/creative-lab/brick-figure/v1/prototype
  • POST /openapi/creative-lab/brick-figure/v1/build
POST/openapi/creative-lab/brick-figure/v1/prototype

Erstellen einer Brick-Figur-Prototyp-Aufgabe

Erzeugen Sie ein einzelnes Konzeptbild im Brick-Stil aus dem Quellfoto. Die zurückgegebene Aufgaben-ID ist das, was Sie als input_task_id an den Build- Endpunkt übergeben. Siehe Das Brick-Figur-Prototyp-Aufgabenobjekt für die Antwortstruktur.

Parameter

  • Name
    image_url
    Type
    string
    Erforderlich
    Description

    Quellfoto, das Meshy als Brick-Minifigur stilisieren soll. Wir unterstützen derzeit die Formate .jpg, .jpeg, .png und .webp.

    Es gibt zwei Möglichkeiten, das Bild bereitzustellen:

    • Öffentlich zugängliche URL: Eine URL, die aus dem öffentlichen Internet zugänglich ist.
    • Data URI: Eine base64-kodierte Data URI des Bildes. Beispiel einer Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
  • Name
    name
    Type
    string
    Description

    Optionaler Aufgabenname für Anzeigezwecke. Maximal 100 Zeichen.

  • Name
    remove_background
    Type
    boolean
    Standard false
    Description

    Wenn auf true gesetzt, wird das Prototypbild als transparentes RGBA-PNG mit entferntem Hintergrund zurückgegeben, sodass Sie das Subjekt auf jeden Hintergrund setzen können.

Rückgaben

Die result-Eigenschaft der Antwort enthält die Aufgaben-id der neu erstellten Brick-Figur-Prototyp-Aufgabe. Abfragen Sie den Get a Task Endpunkt oder abonnieren Sie den Stream, bis die Aufgabe den Status SUCCEEDED erreicht, und übergeben Sie dann diese ID an den Build-Endpunkt als input_task_id.

Fehlermodi

  • Name
    400 - Bad Request
    Description

    Die Anfrage war nicht akzeptabel. Häufige Ursachen:

    • Fehlender Parameter: image_url ist erforderlich.
    • Ungültiges Bildformat: Die bereitgestellte image_url ist kein unterstütztes Format (.jpg, .jpeg, .png, .webp).
    • Bildabmessungen außerhalb des Bereichs: Das Bild ist zu klein, überschreitet die maximale Dateigröße oder die maximale Pixelanzahl.
    • Nicht erreichbare URL: Die image_url konnte nicht heruntergeladen werden (404 oder timeout).
    • Ungültige Data URI: Der base64-String ist fehlerhaft.
    • Inhalt markiert: Das Eingabebild wurde durch NSFW moderation markiert.
  • Name
    401 - Unauthorized
    Description

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

  • Name
    402 - Payment Required
    Description

    Unzureichende Credits, um diese Aufgabe auszuführen.

  • Name
    403 - Forbidden
    Description

    Das Eingabebild wurde wegen einer Verletzung des geistigen Eigentums markiert.

  • Name
    429 - Too Many Requests
    Description

    Sie haben Ihre Ratenbegrenzung überschritten.

Anfrage

POST
/openapi/creative-lab/brick-figure/v1/prototype
# Stage 1: generate a brick-style concept image
curl https://api.meshy.ai/openapi/creative-lab/brick-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>"
  }'

Antwort

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
POST/openapi/creative-lab/brick-figure/v1/build

Erstellen einer Bauaufgabe für eine Ziegelfigur

Generieren Sie die endgültige 3D-Ziegelfigur mit Textur aus einer erfolgreichen Prototypaufgabe. Der Build führt die gleiche Bild-zu-3D-Pipeline aus wie Bild zu 3D, sodass das Format des Antwortobjekts und die Liste der Ausgabe-URLs genau übereinstimmen. Weitere Informationen finden Sie unter Das Objekt der Bauaufgabe für die Ziegelfigur für die Antwortstruktur.

Parameter

  • Name
    input_task_id
    Type
    string
    Erforderlich
    Description

    Die Aufgaben-ID einer Prototypaufgabe, die über diesen gleichen OpenAPI-Endpunkt erstellt wurde. Der Prototyp muss mit dem gleichen API-Schlüssel erstellt worden sein, muss SUCCEEDED erreicht haben und muss genau ein Kandidatenbild produziert haben.

    Prototypaufgaben, die über die Webanwendung erstellt wurden, werden nicht akzeptiert — der Bau-Endpunkt akzeptiert nur Prototypaufgaben, die durch POST /openapi/creative-lab/brick-figure/v1/prototype produziert wurden, und lehnt jede andere Quelle mit 404 ab.

  • Name
    name
    Type
    string
    Description

    Optionaler Aufgabenname für Anzeigezwecke. Maximal 100 Zeichen.

Rückgaben

Die result-Eigenschaft der Antwort enthält die Aufgaben-id der neu erstellten Bauaufgabe für die Ziegelfigur. Abfragen Sie den Abrufen einer Aufgabe Endpunkt oder abonnieren Sie den Stream, bis die Aufgabe SUCCEEDED erreicht, und laden Sie dann die texturierte GLB von model_urls.glb herunter (oder das OBJ + MTL-Paar von model_urls.obj und model_urls.mtl, wenn Ihre nachgelagerte Pipeline OBJ bevorzugt).

Fehlermodi

  • Name
    400 - Bad Request
    Description

    Die Anfrage war nicht akzeptabel. Häufige Ursachen:

    • Fehlender Parameter: input_task_id ist erforderlich.
    • Ungültige UUID: Die input_task_id ist keine gültige UUID.
    • Elternteil nicht erfolgreich: Die referenzierte Prototypaufgabe hat SUCCEEDED noch nicht erreicht.
    • Kein Kandidat: Die Prototypaufgabe war erfolgreich, hat aber kein Kandidatenbild produziert.
  • Name
    401 - Unauthorized
    Description

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

  • Name
    402 - Payment Required
    Description

    Unzureichende Credits, um diese Aufgabe auszuführen.

  • Name
    404 - Not Found
    Description

    Die referenzierte Prototypaufgabe existiert nicht, gehört einem anderen Benutzer oder wurde über die Webanwendung erstellt (nur API-Modus-Prototypaufgaben werden in den Build eingebunden).

  • Name
    429 - Too Many Requests
    Description

    Sie haben Ihre Ratenbegrenzung überschritten.

Anfrage

POST
/openapi/creative-lab/brick-figure/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

Antwort

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

Abrufen einer Brick-Figur-Aufgabe

Abrufen einer Prototyp- oder Bauaufgabe mit einer gültigen Aufgaben-id. Der URL-Pfad muss der Phase der Aufgabe entsprechen — eine Bauaufgabe, die über /prototype/:id abgerufen wird, gibt 404 zurück und umgekehrt.

Siehe Das Brick-Figur-Prototyp-Aufgabenobjekt und Das Brick-Figur-Bauaufgabenobjekt für Antwortformate.

Parameter

  • Name
    id
    Type
    path
    Description

    Eindeutiger Bezeichner für die abzurufende Brick-Figur-Aufgabe.

Rückgaben

Die Antwort enthält das Brick-Figur-Aufgabenobjekt. Das Format hängt von der angeforderten Phase ab.

Anfrage

GET
/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototyp-Antwort

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-brick-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Bau-Antwort

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "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/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}
DELETE/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id

Löschen einer Brick-Figur-Aufgabe

Eine Brick-Figur-Aufgabe abbrechen. Wenn die Aufgabe noch PENDING ist, werden die bei der Erstellung verbrauchten Credits zurückerstattet. Aufgaben, die bereits IN_PROGRESS sind, werden ohne Rückerstattung abgebrochen (der Arbeiter könnte bereits Ressourcen verbrauchen). Aufgaben, die bereits einen Endzustand erreicht haben (SUCCEEDED, FAILED, CANCELED), können nicht abgebrochen werden.

Der URL-Pfad muss mit der Phase der Aufgabe übereinstimmen — DELETE auf /prototype/:buildId gibt 404 zurück.

Pfadparameter

  • Name
    id
    Type
    path
    Description

    Eindeutiger Bezeichner für die Brick-Figur-Aufgabe, die abgebrochen werden soll.

Rückgaben

Gibt 204 No Content bei Erfolg mit leerem Körper zurück.

Fehlermodi

  • Name
    400 - Bad Request
    Description

    Die Aufgabe befindet sich bereits in einem Endzustand und kann nicht abgebrochen werden.

  • Name
    404 - Not Found
    Description

    Die Aufgabe existiert nicht, gehört einem anderen Benutzer oder ihre Phase stimmt nicht mit dem URL-Pfad überein.

Anfrage

DELETE
/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Antwort

// Returns 204 No Content on success (empty body).
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)/:id/stream

Streamen einer Brick-Figur-Aufgabe

Streamen Sie Echtzeit-Updates für eine Brick-Figur-Aufgabe über Server-Sent Events (SSE). Der URL-Pfad muss mit der Phase der Aufgabe übereinstimmen — das Öffnen eines Streams bei /prototype/:buildId/stream sendet ein einzelnes event: error Payload mit status_code: 404 und schließt den Stream.

Parameter

  • Name
    id
    Type
    path
    Description

    Eindeutiger Bezeichner für die zu streamende Brick-Figur-Aufgabe.

Rückgaben

Gibt einen Stream von Brick-Figur-Prototyp oder Brick-Figur-Build Aufgabenobjekten als Server-Sent Events zurück. Für PENDING oder IN_PROGRESS Aufgaben wird der Antwortstream nur die notwendigen progress und status Felder enthalten.

Anfrage

GET
/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream
curl -N https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Antwortstream

// 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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}
GET/openapi/creative-lab/brick-figure/v1/(prototype|build)

Liste der Brick-Figur-Aufgaben

Abrufen einer paginierten Liste Ihrer Brick-Figur-Aufgaben für eine einzelne Phase. Der URL-Pfad wählt die Phase aus — /prototype gibt Prototyp-Aufgaben zurück; /build gibt Bauaufgaben zurück. Aufgaben aus der anderen Phase sind in keiner der Antworten enthalten.

Pfadparameter

  • Name
    stage
    Type
    path
    Erforderlich
    Description

    Entweder prototype oder build. Die Sammlung gibt nur Aufgaben zurück, deren Phase mit der URL übereinstimmt — das Abrufen von /prototype gibt niemals Bauaufgaben zurück und umgekehrt.

Abfrageparameter

  • Name
    page_num
    Type
    integer
    Standard 1
    Description

    Seitennummer für die Paginierung.

  • Name
    page_size
    Type
    integer
    Standard 10
    Description

    Seitenlimit. Maximal erlaubt sind 100 Elemente.

  • Name
    sort_by
    Type
    string
    Standard -created_at
    Description

    Feld zum Sortieren. Verfügbare Werte:

    • +created_at: Sortieren nach Erstellungszeit in aufsteigender Reihenfolge.
    • -created_at: Sortieren nach Erstellungszeit in absteigender Reihenfolge.

Rückgaben

Gibt eine paginierte Liste des phasenbezogenen Aufgabenobjekts zurück — entweder das Brick-Figur-Prototyp-Aufgabenobjekt beim Auflisten von /prototype oder das Brick-Figur-Bauaufgabenobjekt beim Auflisten von /build.

Anfrage

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

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

Antwort (Liste der Prototyp-Aufgaben)

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "creative-lab-brick-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729123456000,
    "started_at": 1729123460000,
    "finished_at": 1729123486000,
    "expires_at": 1729382686000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Das Brick-Figur-Prototyp-Task-Objekt

Das Brick-Figur-Prototyp-Task-Objekt ist eine Arbeitseinheit, die Meshy verfolgt, um ein Konzeptbild im Brick-Stil aus einem Quellfoto zu generieren. Das Ergebnis dieser Phase wird über input_task_id in die Bauphase eingebunden.

Eigenschaften

  • Name
    id
    Type
    string
    Description

    Eindeutiger Bezeichner für die Aufgabe. Obwohl wir eine k-sortierbare UUID für Aufgaben-IDs als Implementierungsdetail verwenden, sollten Sie keine Annahmen über das Format der ID machen.

  • Name
    type
    Type
    string
    Description

    Typ der Aufgabe. Der Wert ist creative-lab-brick-figure-prototype.

  • Name
    name
    Type
    string
    Description

    Der bei der Erstellung der Aufgabe angegebene Aufgabenname. Leerer String, wenn kein Name angegeben wurde.

  • Name
    status
    Type
    string
    Description

    Status der Aufgabe. Mögliche Werte sind einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald die Aufgabe erfolgreich abgeschlossen ist, wird dies 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

    Ein Zeitstempel repräsentiert die Anzahl der Millisekunden, die seit dem 1. Januar 1970 UTC vergangen sind, gemäß dem RFC 3339 Standard. Zum Beispiel wird Freitag, der 1. September 2023, 12:00:00 Uhr GMT als 1693569600000 dargestellt. Dies gilt für alle Zeitstempel in der Meshy API.

  • Name
    started_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft null.

  • Name
    finished_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden. Wenn die Aufgabe noch nicht abgeschlossen ist, ist diese Eigenschaft null.

  • Name
    expires_at
    Type
    timestamp
    Description

    Zeitstempel, wann das Ergebnis der Aufgabe abläuft, in Millisekunden.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Die Anzahl der vorhergehenden Aufgaben.

    Der Wert dieses Feldes ist nur dann sinnvoll, wenn der Aufgabenstatus PENDING ist.

  • Name
    task_error
    Type
    object
    Description

    Fehlerdetails für fehlgeschlagene Aufgaben. Siehe Fehler für die vollständige task_error Objekt-Referenz.

  • Name
    consumed_credits
    Type
    integer
    Description

    Die Anzahl der von dieser Aufgabe verbrauchten Credits. Vorhanden, wenn der Aufgabenstatus PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt 0 für FAILED Aufgaben zurück (Credits werden bei einem Fehler erstattet).

  • Name
    image_urls
    Type
    array of strings
    Description

    Herunterladbare URLs für die von dieser Prototyp-Aufgabe generierten Konzeptbildkandidaten. Derzeit gibt die API immer genau einen Kandidaten zurück; das Feld ist ein Array, sodass zukünftige Revisionen mehrere Kandidaten ohne eine breaking change anzeigen können.

Beispiel Brick-Figur-Prototyp-Task-Objekt

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-brick-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Das Brick Figure Build Task-Objekt

Das Brick Figure Build Task-Objekt ist eine Arbeitseinheit, die Meshy verfolgt, um eine texturierte 3D-Brick-Figur aus einer erfolgreichen Prototyp-Aufgabe zu generieren. Es verwendet die gleiche Bild-zu-3D-Pipeline wie Bild zu 3D, sodass die Ausgabefelder dem Task-Objekt dieses Endpunkts entsprechen.

Eigenschaften

  • Name
    id
    Type
    string
    Description

    Eindeutiger Bezeichner für die Aufgabe.

  • Name
    type
    Type
    string
    Description

    Typ der Aufgabe. Der Wert ist creative-lab-brick-figure-build.

  • Name
    name
    Type
    string
    Description

    Der bei der Erstellung der Aufgabe angegebene Aufgabenname. Leerer String, wenn kein Name angegeben wurde.

  • Name
    status
    Type
    string
    Description

    Status der Aufgabe. Mögliche Werte sind PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, ist dieser Wert 0. Sobald die Aufgabe erfolgreich abgeschlossen ist, wird dieser Wert 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

  • Name
    started_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden.

  • Name
    finished_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden.

  • Name
    expires_at
    Type
    timestamp
    Description

    Zeitstempel, wann das Ergebnis der Aufgabe abläuft, in Millisekunden.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Die Anzahl der vorhergehenden Aufgaben. Nur sinnvoll, wenn der Status PENDING ist.

  • Name
    task_error
    Type
    object
    Description

    Fehlerdetails für fehlgeschlagene Aufgaben. Siehe Fehler für die vollständige Referenz des task_error-Objekts.

  • Name
    consumed_credits
    Type
    integer
    Description

    Die Anzahl der von dieser Aufgabe verbrauchten Credits. Gibt 0 für FAILED-Aufgaben zurück (Credits werden bei einem Fehler erstattet).

  • Name
    prompt
    Type
    string
    Description

    Immer leer für Brick Figure Build. Vorhanden für die Kompatibilität zwischen Endpunkten mit der gemeinsamen V2ImageTo3DTaskResponse-Form, die von Bild zu 3D verwendet wird.

  • Name
    negative_prompt
    Type
    string
    Description

    Immer leer für Brick Figure Build. Vorhanden für die Kompatibilität zwischen Endpunkten.

  • Name
    texture_prompt
    Type
    string
    Description

    Immer leer für Brick Figure Build. Vorhanden für die Kompatibilität zwischen Endpunkten.

  • Name
    texture_image_url
    Type
    string
    Description

    Immer leer für Brick Figure Build. Vorhanden für die Kompatibilität zwischen Endpunkten.

  • Name
    model_urls
    Type
    object
    Description

    Herunterladbare URLs für das generierte 3D-Modell. Der Brick Figure Build gibt eine texturierte GLB sowie das OBJ + MTL-Paar für Pipelines aus, die Wavefront OBJ bevorzugen. Die Feldstruktur entspricht dem Bild zu 3D model_urls-Objekt, sodass zukünftige Format-Ergänzungen ohne Breaking Change eingefügt werden können.

    • Name
      glb
      Type
      string
      Description

      Herunterladbare URL zur texturierten GLB-Datei.

    • Name
      obj
      Type
      string
      Description

      Herunterladbare URL zur Wavefront OBJ-Datei (Geometrie + UV).

    • Name
      mtl
      Type
      string
      Description

      Herunterladbare URL zur MTL-Materialdatei, die zur OBJ-Datei gehört. Kombinieren Sie sie mit obj und dem Eintrag aus texture_urls[0].base_color.

  • Name
    thumbnail_url
    Type
    string
    Description

    Herunterladbare URL zum Miniaturbild der Modelldatei.

  • Name
    texture_urls
    Type
    array
    Description

    Ein Array von Textur-URL-Objekten, die von dieser Aufgabe generiert wurden. Derzeit enthält es ein einzelnes Objekt mit der Basisfarbkarte.

    • Name
      base_color
      Type
      string
      Description

      Herunterladbare URL zum Basisfarbkartenbild.

Beispiel Brick Figure Build Task-Objekt

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "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/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ]
}