API Brick Figure di Creative Lab

Trasforma una foto in una statuina 3D da collezione in stile mattoncino in due fasi. Un'attività di prototipo genera un'immagine concettuale dalla foto. Un'attività di build trasforma quell'immagine in un modello 3D texturizzato e utilizza l'ID dell'attività di prototipo come input_task_id.

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

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

Crea un'attività di prototipo Brick Figure

Genera un'immagine concettuale in stile mattoncino a partire da una foto. Per costruire il modello 3D, passa l'ID di questa attività all'endpoint di build come input_task_id. Per i campi dell'attività, consulta L'oggetto attività di prototipo Brick Figure.

Request

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>"
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

Parametri

Name
image_url
Type
string
Obbligatorio
Description
La foto da trasformare in una minifigure di mattoncini, come URL pubblico o data URI (data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>).
L'immagine deve essere un file JPG, JPEG, PNG o WebP di al massimo 20 MB.
Name
name
Type
string
Description
Un nome per l'attività, fino a 100 caratteri. Viene restituito nel campo name dell'attività. Un nome più lungo restituisce 400.
Name
remove_background
Type
boolean
predefinito false
Description
Se rimuovere lo sfondo dall'immagine del prototipo. true restituisce un PNG RGBA trasparente, così puoi posizionare il soggetto su qualsiasi sfondo. Anche la build parte dall'immagine senza sfondo. Se Meshy non riesce a rimuovere lo sfondo, restituisce l'immagine con il suo sfondo, e l'attività comunque riesce.

Valori restituiti

Il campo result contiene l'ID della nuova attività di prototipo. Recupera l'attività o trasmettila in streaming finché status non è SUCCEEDED. Quindi passa l'ID all'endpoint di build come input_task_id.

Modalità di fallimento

Name
400 - Bad Request
Description
La richiesta non può essere eseguita. Ad esempio:
- image_url manca.
- L'immagine non è un file JPG, JPEG, PNG o WebP.
- L'immagine è troppo piccola, supera i 20 MB, o supera il conteggio massimo di pixel.
- Meshy non riesce a scaricare l'immagine, ad esempio perché l'URL restituisce 404 o va in timeout.
- Il data URI non è un base64 valido.
- L'immagine è stata segnalata come NSFW.
Il messaggio di errore indica quale problema ha riscontrato. Correggi la richiesta, quindi inviala di nuovo.
Name
401 - Unauthorized
Description
La chiave API è mancante o non valida. Controlla l'header Authorization.
Name
402 - Payment Required
Description
Si applica una delle seguenti condizioni:
- L'account non ha crediti sufficienti.
- La chiave API, lo spazio di lavoro o il membro ha raggiunto il proprio limite di crediti.
- L'account è sul piano gratuito.
Controlla i tuoi crediti e il tuo piano, quindi riprova.
Name
403 - Forbidden
Description
Il tuo team ha attivato il Filtraggio IP, e Meshy ha segnalato l'immagine per proprietà intellettuale di terzi. Invia un'immagine che hai il diritto di utilizzare.
Name
429 - Too Many Requests
Description
È stato raggiunto uno di questi limiti:
- Hai inviato più richieste di quante ne consenta il tuo limite di frequenza. Attendi qualche secondo, quindi riprova. Consulta Limiti di frequenza.
- Troppe delle tue attività sono in coda o in esecuzione. Attendi che alcune terminino, quindi riprova.
- Su un piano illimitato senza crediti residui, hai raggiunto il numero di attività che possono essere eseguite senza crediti. Attendi che un'attività termini, oppure aggiungi crediti.
Name
500 - Internal Server Error
Description
Meshy ha riscontrato un errore del server, ad esempio perché non è riuscita a eseguire il controllo di proprietà intellettuale sull'immagine. Meshy non crea l'attività, e rimborsa eventuali crediti addebitati. Riprova la richiesta.

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

Crea un'attività di build della statuina Brick Figure

Genera la minifigure 3D texturizzata a partire da un'attività di prototipo riuscita. Per i suoi campi, vedi L'oggetto attività di build Brick Figure.

Request

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"
  }'

Response

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}

Parametri

Name
input_task_id
Type
string
Obbligatorio
Description
L'ID dell'attività di prototipo da costruire. Deve essere un'attività creata dal tuo account con POST /openapi/creative-lab/brick-figure/v1/prototype, con stato SUCCEEDED.
Un ID che non corrisponde a una delle tue attività di prototipo Brick Figure create tramite API restituisce 404, incluso un prototipo creato nell'app web.
Name
name
Type
string
Description
Un nome per l'attività, fino a 100 caratteri. Viene restituito nel campo name dell'attività. Un nome più lungo restituisce 400.

Risultati restituiti

Il campo result contiene l'ID della nuova attività di build. Recupera l'attività o trasmettila in streaming finché status non è SUCCEEDED. Poi scarica il GLB texturizzato da model_urls.glb. Per un OBJ, scarica invece model_urls.obj con il relativo file materiale da model_urls.mtl.

Modalità di errore

Name
400 - Bad Request
Description
La richiesta non può essere eseguita. Ad esempio:
- input_task_id è mancante o non è un ID attività valido.
- Lo stato dell'attività di prototipo non è SUCCEEDED. Se è ancora in esecuzione, attendi e riprova. Se è fallita o è stata annullata, crea una nuova attività di prototipo.
- L'attività di prototipo è riuscita ma non ha un'immagine. Crea una nuova attività di prototipo.
Il messaggio di errore indica quale problema è stato rilevato.
Name
401 - Unauthorized
Description
La chiave API è mancante o non valida. Controlla l'header Authorization.
Name
402 - Payment Required
Description
Si applica una di queste condizioni:
- L'account non ha crediti sufficienti.
- La chiave API, lo spazio di lavoro o il membro ha raggiunto il proprio limite di crediti.
- L'account è sul piano gratuito.
Controlla i tuoi crediti e il piano, poi riprova.
Name
404 - Not Found
Description
input_task_id non corrisponde a nessuna attività di prototipo Brick Figure creata dal tuo account tramite API. Un prototipo creato nell'app web restituisce anch'esso 404. Invia l'ID result ricevuto dalla risposta di creazione del prototipo.
Name
429 - Too Many Requests
Description
È stato raggiunto uno di questi limiti:
- Hai inviato più richieste di quante ne consenta il tuo limite di frequenza. Attendi qualche secondo, poi riprova. Vedi Limiti di frequenza.
- Troppe delle tue attività sono in coda o in esecuzione. Attendi che alcune terminino, poi riprova.
- Su un piano illimitato senza crediti residui, hai raggiunto il numero di attività che possono essere eseguite senza crediti. Attendi che un'attività termini, oppure aggiungi crediti.

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

Recupera un task Brick Figure

Restituisce un task di prototipo o di build. Il percorso deve corrispondere alla fase del task. Un task di build richiesto tramite /prototype/:id restituisce 404, e lo stesso vale per un task di prototipo richiesto tramite /build/:id.

Per i campi, consulta L'oggetto task di prototipo Brick Figure e L'oggetto task di build Brick Figure.

Request

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}"

Prototype Response

{
  "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=***"
  ]
}

Build Response

{
  "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=***"
    }
  ]
}

Parametri

Name
id
Type
path
Description
L'ID del task ottenuto dalla risposta di creazione.

Risultato

L'oggetto task di prototipo o l'oggetto task di build, a seconda della fase indicata nel percorso.

Modalità di errore

Name
400 - Bad Request
Description
id non è un ID di task valido. Invia l'ID result ottenuto dalla risposta di creazione.
Name
403 - Forbidden
Description
Il tuo team ha attivato il Filtraggio IP, e Meshy ha segnalato l'immagine del task per proprietà intellettuale di terzi. I team con piano Enterprise non ricevono questo errore. Crea un task di prototipo da un'immagine di cui hai i diritti d'uso.
Name
404 - Not Found
Description
Nessun task Brick Figure con questo ID appartiene al tuo account, oppure la fase del task non corrisponde al percorso. Controlla l'ID e usa /prototype o /build in base al task.
Name
500 - Internal Server Error
Description
Meshy non è riuscito a eseguire il controllo sulla proprietà intellettuale. Riprova la richiesta.

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

Elimina un'attività Brick Figure

Annulla un'attività Brick Figure. Annullare un'attività PENDING rimborsa i suoi crediti. Un'attività IN_PROGRESS viene annullata senza rimborso, perché un worker l'ha già avviata. Un'attività con uno stato finale (SUCCEEDED, FAILED o CANCELED) non può essere annullata.

Il percorso deve corrispondere alla fase dell'attività. Ad esempio, DELETE su /prototype/:id con l'ID di un'attività di build restituisce 404.

Request

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}"

Response

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

Parametri del percorso

Name
id
Type
path
Description
L'ID dell'attività da annullare.

Restituisce

204 No Content con un corpo vuoto.

Modalità di errore

Name
400 - Bad Request
Description
Si applica una delle seguenti condizioni:
- id non è un ID attività valido. Invia l'ID result dalla risposta di creazione.
- L'attività ha già uno stato finale (SUCCEEDED, FAILED o CANCELED), quindi non può essere annullata.
Name
404 - Not Found
Description
Nessuna attività Brick Figure con questo ID appartiene al tuo account, oppure la fase dell'attività non corrisponde al percorso. Controlla l'ID e usa /prototype o /build per far corrispondere l'attività.

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

Esegui lo streaming di un task Brick Figure

Trasmette in streaming gli aggiornamenti di un task Brick Figure come Server-Sent Events (SSE). Il percorso deve corrispondere alla fase del task. In caso contrario, ad esempio l'ID di un task di build su /prototype/:id/stream, lo stream invia un singolo evento error con status_code: 404 e si chiude.

Request

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}"

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": "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=***"
    }
  ]
}

Parametri

Name
id
Type
path
Description
L'ID del task dalla risposta di creazione.

Valori restituiti

Uno stream di oggetti task di prototipo o build. Ogni evento contiene l'oggetto task completo, così come restituito da Recupera un task Brick Figure. Finché il task è PENDING o IN_PROGRESS, i suoi campi di output sono ancora vuoti (null, [] o {}), e finished_at è null.

Se il Filtro IP blocca il risultato del task, lo stream invia al suo posto un singolo evento error, con lo status_code che una richiesta get restituirebbe.

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

Elenca le attività Brick Figure

Restituisce le tue attività Brick Figure di una fase, una pagina alla volta. Il percorso seleziona la fase. /prototype restituisce solo le attività di prototype, e /build restituisce solo le attività di build.

Request

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}"

Response (List Prototype Tasks)

[
  {
    "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=***"
    ]
  }
]

Parametri del percorso

Name
stage
Type
path
Obbligatorio
Description
La fase da elencare, prototype o build.

Parametri della query

Name
page_num
Type
integer
predefinito 1
Description
La pagina da restituire, da 1 a 255. 0 restituisce la prima pagina. Un valore al di fuori dell'intervallo 0-255 restituisce 400.
Name
page_size
Type
integer
predefinito 10
Description
Numero di attività per pagina, fino a 100. Un valore da 101 a 255 restituisce 100 attività, e 0 utilizza il valore predefinito. Un valore al di fuori dell'intervallo 0-255 restituisce 400.
Name
sort_by
Type
string
predefinito -created_at
Description
L'ordine di ordinamento.
Valori disponibili:
- -created_at: prima le più recenti
- +created_at: prima le più vecchie

Restituisce

Un array di oggetti attività prototype o di oggetti attività build, corrispondenti alla fase indicata nel percorso.

L'oggetto task del prototipo della statuina di mattoncini

Un task di prototipo genera un'immagine concettuale in stile mattoncini a partire da una foto. Per trasformare l'immagine in un modello 3D, passa l'ID del task all'endpoint di build come input_task_id.

Proprietà

Example Brick Figure Prototype Task Object

{
  "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=***"
  ]
}

Name
id
Type
string
Description
L'ID del task. Non fare affidamento sul suo formato.
Name
type
Type
string
Description
Il tipo di task, sempre creative-lab-brick-figure-prototype.
Name
name
Type
string
Description
Il name inviato alla creazione del task, oppure "" se non ne è stato inviato uno.
Name
status
Type
string
Description
Lo stato del task.
Valori disponibili:
- PENDING: in attesa in coda
- IN_PROGRESS: generazione del risultato in corso
- SUCCEEDED: finale, con il risultato
- FAILED: finale, con il motivo in task_error
- CANCELED: finale, senza risultato
Name
progress
Type
integer
Description
Percentuale del lavoro completato, da 0 a 100. È 0 finché il task non inizia e 100 quando ha successo.
Name
created_at
Type
timestamp
Description
Momento in cui il task è stato creato, in millisecondi Unix.
Name
started_at
Type
timestamp
Description
Momento in cui un worker ha avviato il task, in millisecondi Unix. null fino ad allora.
Name
finished_at
Type
timestamp
Description
Momento in cui il task ha raggiunto uno stato finale, in millisecondi Unix. null fino ad allora.
Name
expires_at
Type
timestamp
Description
Momento in cui il risultato del task scade, in millisecondi Unix. Sono 3 giorni dopo finished_at, oppure 3 giorni dopo created_at finché il task non termina. Per gli account Enterprise, che conservano i risultati delle API a tempo indeterminato, sono circa 100 anni dopo. Vedi Conservazione degli asset.
Name
preceding_tasks
Type
integer
Description
La posizione del task in coda mentre è PENDING. 1 significa che inizierà come prossimo. 0 dopo che il task esce dalla coda, e sempre 0 nei risultati degli elenchi.
Name
task_error
Type
object
Description
Il motivo per cui il task è fallito. null a meno che status non sia FAILED. Vedi Errori.
Name
consumed_credits
Type
integer
Description
Numero di crediti addebitati per il task, dopo eventuali rimborsi. Una richiesta che restituisce un errore non viene addebitata. Un task fallito è 0, perché Meshy lo rimborsa. L'annullamento rimborsa un task solo mentre è PENDING. Se Meshy non riesce a leggere l'addebito, una risposta get o stream omette il campo, e una richiesta di elenco restituisce 500. In tal caso, riprova la richiesta.
Name
image_urls
Type
array of strings
Description
URL di download per l'immagine concettuale. L'array contiene un URL dopo che il task ha avuto successo, ed è vuoto fino ad allora.

L'oggetto del task di build della statuina Brick Figure

Un task di build genera una statuina minifigure 3D con texture a partire da un task di prototipo riuscito. I suoi campi model_urls, thumbnail_url e texture_urls hanno lo stesso formato dell'oggetto del task Immagine in 3D.

Proprietà

Example Brick Figure Build Task Object

{
  "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=***"
    }
  ]
}

Name
id
Type
string
Description
L'ID del task. Non fare affidamento sul suo formato.
Name
type
Type
string
Description
Il tipo di task, sempre creative-lab-brick-figure-build.
Name
name
Type
string
Description
Il name inviato durante la creazione del task, oppure "" se non ne è stato inviato uno.
Name
status
Type
string
Description
Lo stato del task.
Valori disponibili:
- PENDING: in attesa in coda
- IN_PROGRESS: generazione del risultato in corso
- SUCCEEDED: finale, con il risultato
- FAILED: finale, con il motivo in task_error
- CANCELED: finale, senza risultato
Name
progress
Type
integer
Description
Percentuale del lavoro completato, da 0 a 100. È 0 finché il task non inizia e 100 quando ha successo.
Name
created_at
Type
timestamp
Description
Momento in cui il task è stato creato, in millisecondi Unix.
Name
started_at
Type
timestamp
Description
Momento in cui un worker ha avviato il task, in millisecondi Unix. null fino ad allora.
Name
finished_at
Type
timestamp
Description
Momento in cui il task ha raggiunto uno stato finale, in millisecondi Unix. null fino ad allora.
Name
expires_at
Type
timestamp
Description
Momento in cui il risultato del task scade, in millisecondi Unix. È 3 giorni dopo finished_at, oppure 3 giorni dopo created_at finché il task non termina. Per gli account Enterprise, che conservano i risultati delle API a tempo indeterminato, è circa 100 anni dopo. Vedi Conservazione degli asset.
Name
preceding_tasks
Type
integer
Description
La posizione del task in coda mentre è PENDING. 1 significa che inizierà come prossimo. 0 dopo che il task esce dalla coda, e sempre 0 nei risultati degli elenchi.
Name
task_error
Type
object
Description
Il motivo per cui il task è fallito. null a meno che status non sia FAILED. Vedi Errori.
Name
consumed_credits
Type
integer
Description
Numero di crediti addebitati per il task, dopo eventuali rimborsi. Una richiesta che restituisce un errore non viene addebitata. Un task fallito è 0, perché Meshy lo rimborsa. L'annullamento rimborsa un task solo mentre è PENDING. Se Meshy non riesce a leggere l'addebito, una risposta get o stream omette il campo, e una richiesta di elenco restituisce 500. In tal caso, riprova la richiesta.
Name
prompt
Type
string
Description
Sempre "" per un task di build Brick Figure.
Name
negative_prompt
Type
string
Description
Sempre "" per un task di build Brick Figure, come prompt.
Name
texture_prompt
Type
string
Description
Sempre "" per un task di build Brick Figure, come prompt.
Name
texture_image_url
Type
string
Description
Sempre "" per un task di build Brick Figure, come prompt.
Name
model_urls
Type
object
Description
URL di download per il modello 3D, come GLB con texture e come file OBJ con il relativo file MTL.
- Name
  glb
  Type
  string
  Description
  URL di download per il file GLB con texture.
- Name
  obj
  Type
  string
  Description
  URL di download per il file OBJ, con geometria e UV.
- Name
  mtl
  Type
  string
  Description
  URL di download per il file materiale MTL abbinato a obj. Usalo insieme a obj e alla texture in texture_urls[0].base_color.
Name
thumbnail_url
Type
string
Description
URL di download per un'immagine di anteprima del modello.
Name
texture_urls
Type
array
Description
Le mappe texture, come array con un oggetto che contiene la mappa del colore base.
- Name
  base_color
  Type
  string
  Description
  URL di download per la mappa del colore base.