API Statuina di Creative Lab

Trasforma una foto in una statuina 3D da collezione in stile chibi 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/figure/v1/prototype
POST /openapi/creative-lab/figure/v1/build

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

Crea un'attività di prototipo Figure

Genera un'immagine concettuale in stile chibi 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à, vedi L'oggetto attività di prototipo Figure.

Request

POST

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

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

Prototype example

Start with a source portrait, then generate the prototype image used by the build stage.

Source portrait used as the Creative Lab Figure input — Prototype input

Chibi-style figurine prototype image generated from the source photo — Prototype output

Parametri

Name
image_url
Type
string
Obbligatorio
Description
La foto da trasformare in una statuina chibi, come URL pubblico o come 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 collocare il soggetto su qualsiasi sfondo. Anche la build parte dall'immagine senza il suo sfondo. Se Meshy non riesce a rimuovere lo sfondo, restituisce l'immagine con il suo sfondo, e l'attività comunque va a buon fine.

Valori restituiti

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

Modalità di errore

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, oppure supera il numero 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 è una base64 valida.
- L'immagine è stata segnalata come NSFW.
Il messaggio di errore indica quale problema è stato rilevato. Correggi la richiesta, poi inviala di nuovo.
Name
401 - Unauthorized
Description
La chiave API manca 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, poi 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 dei seguenti limiti:
- Hai inviato più richieste di quante il tuo limite di frequenza ne consenta. Attendi qualche secondo, poi riprova. Vedi Limiti di frequenza.
- Troppe delle tue attività sono in coda o in esecuzione. Attendi che alcune finiscano, 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à finisca, oppure aggiungi crediti.
Name
500 - Internal Server Error
Description
Meshy ha riscontrato un errore del server, ad esempio perché non è riuscito a eseguire il controllo della proprietà intellettuale sull'immagine. Meshy non crea l'attività e rimborsa eventuali crediti addebitati. Riprova la richiesta.

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

Crea un'attività di build Figure

Genera la statuina 3D texturizzata a partire da un'attività prototipo completata con successo. Per i suoi campi, vedi L'oggetto attività di build Figure.

Request

POST

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

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/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"
}

Esempio di build

L'attività di build trasforma l'immagine prototipo selezionata in un modello 3D texturizzato scaricabile.

Anteprima del modello di build Figure di Creative Lab — Anteprima del modello di build

Parametri

Name
input_task_id
Type
string
Obbligatorio
Description
L'ID dell'attività prototipo da costruire. Deve essere un'attività creata dal tuo account con POST /openapi/creative-lab/figure/v1/prototype, con stato SUCCEEDED.
Un ID che non corrisponde a una delle tue attività prototipo Figure dell'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 seguila in streaming finché status non è SUCCEEDED. Poi scarica il GLB texturizzato da model_urls.glb. Per un OBJ invece, scarica model_urls.obj con il suo 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à prototipo non è SUCCEEDED. Se è ancora in esecuzione, attendi e riprova. Se è fallita o è stata annullata, crea una nuova attività prototipo.
- L'attività prototipo è riuscita ma non ha un'immagine. Crea una nuova attività prototipo.
Il messaggio di errore indica quale problema ha riscontrato.
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 tuo piano, poi riprova.
Name
404 - Not Found
Description
input_task_id non corrisponde a nessuna attività prototipo Figure creata dal tuo account tramite l'API. Un prototipo creato nell'app web restituisce anch'esso 404. Invia l'ID result proveniente da una 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/figure/v1/(prototype|build)/:id

Recupera un task Figure

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

Per i campi, vedi L'oggetto task prototype Figure e L'oggetto task build Figure.

Request

GET

/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

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

# Build
curl https://api.meshy.ai/openapi/creative-lab/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-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-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 dalla risposta di creazione.

Restituisce

L'oggetto task prototype o l'oggetto task build, corrispondente allo stage nel percorso.

Modalità di errore

Name
400 - Bad Request
Description
id non è un ID di task valido. Invia l'ID result dalla risposta di creazione.
Name
403 - Forbidden
Description
Il tuo team ha il Filtraggio IP attivato, e Meshy ha segnalato l'immagine del task per proprietà intellettuale di terze parti. I team con piano Enterprise non ricevono questo errore. Crea un task di prototype da un'immagine di cui possiedi i diritti d'uso.
Name
404 - Not Found
Description
Nessun task Figure con questo ID appartiene al tuo account, oppure lo stage 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/figure/v1/(prototype|build)/:id

Elimina un task Figure

Annulla un task Figure. L'annullamento di un task PENDING rimborsa i suoi crediti. Un task IN_PROGRESS viene annullato senza rimborso, perché un worker lo ha già avviato. Un task con uno stato finale (SUCCEEDED, FAILED o CANCELED) non può essere annullato.

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

Request

DELETE

/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/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 del task 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 di task valido. Invia l'ID result dalla risposta di creazione.
- Il task ha già uno stato finale (SUCCEEDED, FAILED o CANCELED), quindi non può essere annullato.
Name
404 - Not Found
Description
Nessun task 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 per far corrispondere il task.

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

Esegui lo streaming di un'attività Figure

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

Request

GET

/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream

curl -N https://api.meshy.ai/openapi/creative-lab/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-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 dell'attività proveniente dalla risposta di creazione.

Risultati restituiti

Uno stream di oggetti attività prototype o build. Ogni evento contiene l'oggetto attività completo, così come lo restituisce Recupera un'attività Figure. Mentre l'attività è PENDING o IN_PROGRESS, i suoi campi di output sono ancora vuoti (null, [] o {}), e finished_at è null.

Se il filtraggio IP blocca il risultato dell'attività, lo stream invia al suo posto un evento error, con lo status_code che una richiesta get restituirebbe.

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

Elenco attività Figure

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

Request

GET

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

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

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/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-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 di 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 di 0-255 restituisce 400.
Name
sort_by
Type
string
predefinito -created_at
Description
L'ordine di ordinamento.
Valori disponibili:
- -created_at: le più recenti per prime
- +created_at: le meno recenti per prime

Restituisce

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

L'oggetto task di prototipo statuina

Un task di prototipo genera un'immagine concettuale in stile chibi 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 Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-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-figure-prototype.
Name
name
Type
string
Description
Il name inviato alla creazione del task, oppure "" se non ne hai 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 partirà subito dopo. 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 task di build della statuina

Un task di build genera una statuina 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 task Immagine in 3D.

Proprietà

Example Figure Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-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-figure-build.
Name
name
Type
string
Description
Il name inviato al momento della creazione del task, oppure "" se non ne è stato inviato uno.
Name
status
Type
string
Description
Lo stato del task.
Valori disponibili:
- PENDING: in attesa nella 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 nella coda mentre è PENDING. 1 significa che è il prossimo ad iniziare. 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 questo caso, ripeti la richiesta.
Name
prompt
Type
string
Description
Sempre "" per un task di build di una statuina.
Name
negative_prompt
Type
string
Description
Sempre "" per un task di build di una statuina, come prompt.
Name
texture_prompt
Type
string
Description
Sempre "" per un task di build di una statuina, come prompt.
Name
texture_image_url
Type
string
Description
Sempre "" per un task di build di una statuina, 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 la geometria e le 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 di texture, come array con un unico oggetto che contiene la mappa del colore base.
- Name
  base_color
  Type
  string
  Description
  URL di download per la mappa del colore base.