Creative Lab — API magnete da frigo

Trasforma le tue foto in magneti da frigo personalizzati — un rilievo di profondità colorizzato a rettangolo arrotondato con retro magnetico piatto, dimensionato per il frigo — in due fasi: prototipo genera un'immagine concettuale colorizzata dalla tua foto di input, poi build trasforma quell'immagine concettuale in un modello 3D in rilievo. Le due fasi sono collegate tramite input_task_id.

POST /openapi/creative-lab/fridge-magnet/v1/prototype
POST /openapi/creative-lab/fridge-magnet/v1/build

POST/openapi/creative-lab/fridge-magnet/v1/prototype

Crea un'attività prototipo di magnete da frigo

Genera una singola immagine concettuale colorizzata dalla foto sorgente. L'ID dell'attività restituito è ciò che passi come input_task_id all'endpoint di build. Consulta L'oggetto dell'attività prototipo di magnete da frigo per la struttura della risposta.

Parametri

Name
image_url
Type
string
Obbligatorio
Description
Foto sorgente che Meshy deve colorizzare in un'immagine concettuale pronta per il magnete da frigo. Attualmente supportiamo i formati .jpg, .jpeg, .png e .webp.
Ci sono due modi per fornire l'immagine:
- URL accessibile pubblicamente: un URL accessibile da Internet pubblico.
- Data URI: un Data URI dell'immagine codificato in base64. Esempio di Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
Name
name
Type
string
Description
Nome attività opzionale a scopo di visualizzazione. Massimo 100 caratteri.

Restituisce

La proprietà result della risposta contiene l'id dell'attività della nuova attività prototipo di magnete da frigo creata. Esegui il polling dell'endpoint Ottieni un'attività o iscriviti allo stream finché l'attività non raggiunge SUCCEEDED, quindi passa quell'ID all'endpoint di build come input_task_id.

Modalità di errore

Name
400 - Bad Request
Description
La richiesta non era accettabile. Cause comuni:
- Parametro mancante: image_url è obbligatorio.
- Formato immagine non valido: l'image_url fornito non è in un formato supportato (.jpg, .jpeg, .png, .webp).
- Dimensioni dell'immagine fuori intervallo: l'immagine è troppo piccola, supera la dimensione massima del file o supera il numero massimo di pixel.
- URL non raggiungibile: non è stato possibile scaricare l'image_url (404 o timeout).
- Data URI non valido: la stringa base64 è malformata.
- Contenuto segnalato: l'immagine di input è stata segnalata dalla moderation NSFW o della proprietà intellettuale.
Name
401 - Unauthorized
Description
Autenticazione non riuscita. Controlla la tua chiave API.
Name
402 - Payment Required
Description
Crediti insufficienti per eseguire questa attività.
Name
429 - Too Many Requests
Description
Hai superato il tuo limite di frequenza.

Request

POST

/openapi/creative-lab/fridge-magnet/v1/prototype

# Stage 1: generate a colorized fridge magnet concept image
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/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": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9"
}

Prototype example

Start with a source photo, then generate the prototype image used by the fridge magnet build stage.

Source landscape photo used as the Creative Lab Fridge Magnet input — Prototype input

Creative Lab Fridge Magnet prototype output generated from the source photo — Prototype output

POST/openapi/creative-lab/fridge-magnet/v1/build

Crea un'attività di build per un magnete da frigo

Genera il magnete da frigo finale stampabile in 3D da un'attività prototipo riuscita. La build esegue una pipeline di rilievo basata su mappa di profondità sull'immagine concettuale colorizzata del prototipo e fornisce un singolo artefatto mesh nel formato richiesto. Consulta L'oggetto attività di build del magnete da frigo per la struttura della risposta.

Parametri

Name
input_task_id
Type
string
Obbligatorio
Description
L'ID attività di un'attività prototipo creata tramite questo stesso endpoint OpenAPI. Il prototipo deve essere stato creato con la stessa chiave API, deve aver raggiunto SUCCEEDED e deve aver prodotto esattamente un'immagine candidata.
Le attività prototipo create tramite la webapp non sono accettate — l'endpoint di build accetta solo attività prototipo prodotte da POST /openapi/creative-lab/fridge-magnet/v1/prototype e rifiuta qualsiasi altra origine con 404.
Name
name
Type
string
Description
Nome attività opzionale a fini di visualizzazione. Massimo 100 caratteri.

`options`

Parametri di regolazione opzionali per la geometria del rilievo. Ogni campo ha un valore predefinito sensato — invia solo quelli che vuoi sovrascrivere.

Name
badge_shape
Type
string
predefinito rounded-rect
Description
Silhouette del contorno del magnete da frigo. Valori disponibili:
- circle
- rounded-rect (predefinito)
- hexagon
- shield
- star
Name
size_mm
Type
number
predefinito 60
Description
Lunghezza del lato del quadrato di delimitazione del magnete da frigo, in millimetri. Intervallo: (0, 400].
Name
relief_height_mm
Type
number
predefinito 3.3
Description
Altezza massima del rilievo sopra la base, in millimetri. Intervallo: [0, 20].
Name
relief_offset_mm
Type
number
predefinito 0
Description
Offset verticale applicato al rilievo prima dell'estrusione, in millimetri. Intervallo: [0, 20].
Name
base_thickness_mm
Type
number
predefinito 2.0
Description
Spessore della piastra di base piatta dietro il rilievo, in millimetri. Il valore predefinito del magnete da frigo è una base più robusta da 2 mm — offre al magnete abbastanza corpo per aderire al frigo senza che il rilievo sembri fragile. Intervallo: [0, 20].
Name
has_closed_back
Type
boolean
predefinito true
Description
Indica se il retro del magnete da frigo è sigillato come superficie chiusa (il lato su cui incolli il magnete). Imposta su false per un guscio aperto.
Name
relief_curve
Type
string
predefinito linear
Description
Curva di trasferimento che mappa i valori della mappa di profondità all'altezza del rilievo. Valori disponibili:
- linear (predefinito)
- gamma
- s-curve
Name
curve_param
Type
number
predefinito 1.0
Description
Parametro di forma per la curva di trasferimento (significativo solo quando relief_curve è gamma). Intervallo: (0, 10].
Name
invert_depth
Type
boolean
predefinito false
Description
Inverte l'interpretazione della mappa di profondità in modo che le regioni più scure diventino un rilievo più alto.
Name
smoothing
Type
number
predefinito 0.24
Description
Intensità di smoothing applicata alla mappa di profondità prima dell'estrazione del rilievo. Intervallo: [0, 10].
Name
relief_scale
Type
number
predefinito 1.0
Description
Moltiplicatore della scala verticale applicato sopra relief_height_mm. Intervallo: (0, 10].
Name
depth_threshold
Type
number
predefinito 0.1
Description
Soglia passa-basso per i valori della mappa di profondità; qualsiasi valore inferiore viene limitato a zero. Intervallo: [0, 1].
Name
remove_background
Type
boolean
predefinito true
Description
Rimuove automaticamente lo sfondo dell'immagine concettuale del prototipo prima di creare il rilievo.
Name
export_resolution
Type
integer
predefinito 512
Description
Risoluzione della mesh usata per l'export. Intervallo: [64, 2048].

`output`

Selettore opzionale del formato di trasmissione. Il valore predefinito è glb.

Name
format
Type
string
predefinito glb
Description
Pacchetto di artefatti restituito dalla build. Valori disponibili:
- glb (predefinito) — restituisce un singolo model.glb in model_urls.glb.
- obj — comprime model.obj + model.mtl + texture.png e restituisce il pacchetto in model_urls.obj.
- zip — comprime ogni artefatto emesso dal generatore e restituisce il pacchetto in model_urls.bundle_zip.

Restituisce

La proprietà result della risposta contiene l'id attività della nuova attività di build del magnete da frigo. Interroga l'endpoint Ottieni un'attività o iscriviti allo stream finché l'attività non raggiunge SUCCEEDED, quindi scarica l'artefatto dalla singola voce in model_urls.

Modalità di errore

Name
400 - Bad Request
Description
La richiesta non era accettabile. Cause comuni:
- Parametro mancante: input_task_id è obbligatorio.
- UUID non valido: input_task_id non è un UUID valido.
- Padre non riuscito: l'attività prototipo referenziata non ha ancora raggiunto SUCCEEDED.
- Nessun candidato: l'attività prototipo è riuscita ma non ha prodotto alcuna immagine candidata.
- Opzioni fuori intervallo: uno dei campi options è uscito dall'intervallo consentito o dall'insieme enum.
Name
401 - Unauthorized
Description
Autenticazione non riuscita. Controlla la tua chiave API.
Name
402 - Payment Required
Description
Crediti insufficienti per eseguire questa attività.
Name
404 - Not Found
Description
L'attività prototipo referenziata non esiste, appartiene a un utente diverso o è stata creata tramite la webapp (solo le attività prototipo in mode API possono essere concatenate nella build).
Name
429 - Too Many Requests
Description
Hai superato il tuo limite di frequenza.

Request

POST

/openapi/creative-lab/fridge-magnet/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "options": {
      "badge_shape": "rounded-rect",
      "size_mm": 60,
      "relief_height_mm": 3.3
    },
    "output": {
      "format": "glb"
    }
  }'

Response

{
  "result": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0"
}

Build example

The build task turns the selected prototype image into a 3D-printable fridge magnet model.

Anteprima del modello di build del magnete da frigo Creative Lab — Build model preview

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Recupera un'attività di magnete da frigo

Recupera un'attività prototype o build dato un id attività valido. Il percorso URL deve corrispondere alla fase dell'attività: un'attività build recuperata tramite /prototype/:id restituisce 404, e viceversa.

Consulta L'oggetto attività prototype magnete da frigo e L'oggetto attività build magnete da frigo per le strutture delle risposte.

Parametri

Name
id
Type
path
Description
Identificatore univoco per l'attività magnete da frigo da recuperare.

Restituisce

La risposta contiene l'oggetto attività magnete da frigo. La struttura dipende dalla fase richiesta.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

DELETE/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Eliminare un'attività di magnete da frigo

Annulla un'attività di magnete da frigo. Se l'attività è ancora PENDING, i crediti consumati al momento della creazione vengono rimborsati. Le attività che sono già IN_PROGRESS vengono annullate senza rimborso (il worker potrebbe già consumare Risorse). Le attività che hanno già raggiunto uno stato terminale (SUCCEEDED, FAILED, CANCELED) non possono essere annullate.

Il percorso URL deve corrispondere alla fase dell'attività — DELETE su /prototype/:buildId restituisce 404.

Parametri del percorso

Name
id
Type
path
Description
Identificatore univoco dell'attività di magnete da frigo da annullare.

Restituisce

Restituisce 204 No Content in caso di successo con un corpo vuoto.

Modalità di errore

Name
400 - Bad Request
Description
L'attività è già in uno stato terminale e non può essere annullata.
Name
404 - Not Found
Description
L'attività non esiste, appartiene a un utente diverso oppure la sua fase non corrisponde al percorso URL.

Request

DELETE

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

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

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

Trasmetti in streaming un'attività di magnete da frigo

Trasmette aggiornamenti in tempo reale per un'attività di magnete da frigo tramite Server-Sent Events (SSE). Il percorso URL deve corrispondere alla fase dell'attività: l'apertura di uno stream in /prototype/:buildId/stream emette un singolo payload event: error con status_code: 404 e chiude lo stream.

Parametri

Name
id
Type
path
Description
Identificatore univoco dell'attività di magnete da frigo da trasmettere in streaming.

Restituisce

Restituisce uno stream di oggetti attività Prototipo di magnete da frigo o Build di magnete da frigo come Server-Sent Events. Per le attività PENDING o IN_PROGRESS, lo stream di risposta includerà solo i campi progress e status necessari.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream

curl -N https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

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

Elenca le attività di magnete da frigo

Recupera un elenco paginato delle tue attività di magnete da frigo per una singola fase. Il percorso dell'URL seleziona la fase — /prototype restituisce le attività di prototipo; /build restituisce le attività di build. Le attività dell'altra fase non sono incluse in nessuna delle due risposte.

Parametri del percorso

Name
stage
Type
path
Obbligatorio
Description
prototype oppure build. La raccolta restituisce solo le attività la cui fase corrisponde all'URL — il recupero di /prototype non restituisce mai attività di build e viceversa.

Parametri di query

Name
page_num
Type
integer
predefinito 1
Description
Numero di pagina per la paginazione.
Name
page_size
Type
integer
predefinito 10
Description
Limite della dimensione della pagina. Il massimo consentito è 50 elementi.
Name
sort_by
Type
string
predefinito -created_at
Description
Campo in base al quale ordinare. Valori disponibili:
- +created_at: Ordina per ora di creazione in ordine crescente.
- -created_at: Ordina per ora di creazione in ordine decrescente.

Restituisce

Restituisce un elenco paginato dell'oggetto attività per fase — ovvero l'oggetto attività di prototipo del magnete da frigo quando si elenca /prototype oppure l'oggetto attività di build del magnete da frigo quando si elenca /build.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/prototype

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

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

Response (List Prototype Tasks)

[
  {
    "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "type": "creative-lab-fridge-magnet-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729543210000,
    "started_at": 1729543215000,
    "finished_at": 1729543242000,
    "expires_at": 1729802442000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

L'oggetto attività del prototipo di magnete da frigo

L'oggetto attività del prototipo di magnete da frigo è un'unità di lavoro che Meshy traccia per generare un'immagine concettuale colorizzata da una foto sorgente. L'output di questa fase viene collegato alla fase di costruzione tramite input_task_id.

Proprietà

Name
id
Type
string
Description
Identificatore univoco dell'attività. Sebbene utilizziamo un UUID k-sortable per gli id delle attività come dettaglio di implementazione, non dovresti fare alcuna supposizione sul formato dell'id.
Name
type
Type
string
Description
Tipo dell'attività. Il valore è creative-lab-fridge-magnet-prototype.
Name
name
Type
string
Description
Il nome dell'attività fornito al momento della creazione dell'attività. Stringa vuota se non è stato fornito alcun nome.
Name
status
Type
string
Description
Stato dell'attività. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progress dell'attività. Se l'attività non è ancora iniziata, questa proprietà sarà 0. Una volta che l'attività è riuscita, diventerà 100.
Name
created_at
Type
timestamp
Description
Timestamp di quando l'attività è stata creata, in millisecondi.
Un timestamp rappresenta il numero di millisecondi trascorsi dal 1° gennaio 1970 UTC, seguendo lo standard RFC 3339. Ad esempio, venerdì 1 settembre 2023 12:00:00 PM GMT è rappresentato come 1693569600000. Questo si applica a tutti i timestamp in Meshy API.
Name
started_at
Type
timestamp
Description
Timestamp di quando l'attività è stata avviata, in millisecondi. Se l'attività non è ancora iniziata, questa proprietà sarà 0.
Name
finished_at
Type
timestamp
Description
Timestamp di quando l'attività è stata completata, in millisecondi. Se l'attività non è ancora terminata, questa proprietà sarà 0.
Name
expires_at
Type
timestamp
Description
Timestamp di quando il risultato dell'attività scade, in millisecondi.
Name
preceding_tasks
Type
integer
Description
Il numero di attività precedenti.
Il valore di questo campo è significativo solo se lo stato dell'attività è PENDING.
Name
task_error
Type
object
Description
Dettagli dell'errore per le attività non riuscite. Consulta Errori per il riferimento completo all'oggetto task_error.
Name
consumed_credits
Type
integer
Description
Il numero di crediti consumati da questa attività. Presente quando lo stato dell'attività è PENDING, IN_PROGRESS o SUCCEEDED. Restituisce 0 per le attività FAILED (i crediti vengono rimborsati in caso di errore).
Name
image_urls
Type
array of strings
Description
URL scaricabili per le immagini concettuali candidate generate da questa attività prototipo. Attualmente l'API restituisce sempre esattamente una candidata; il campo è un array affinché revisioni future possano esporre più candidate senza una modifica incompatibile.

Example Fridge Magnet Prototype Task Object

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

L'oggetto task di creazione del magnete da frigo

L'oggetto task di creazione del magnete da frigo è un'unità di lavoro che Meshy tiene traccia per generare la mesh 3D finale del magnete da frigo da un task prototipo SUCCEEDED. La creazione esegue una pipeline di rilievo con mappa di profondità sull'immagine concettuale del prototipo e pubblica un singolo artefatto mesh nel formato richiesto dal chiamante.

Proprietà

Name
id
Type
string
Description
Identificatore univoco dell'attività.
Name
type
Type
string
Description
Tipo dell'attività. Il valore è creative-lab-fridge-magnet-build.
Name
name
Type
string
Description
Il nome dell'attività fornito al momento della creazione dell'attività. Stringa vuota se non è stato fornito alcun nome.
Name
status
Type
string
Description
Stato dell'attività. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
progress dell'attività. Se l'attività non è ancora iniziata, questa proprietà sarà 0. Una volta che l'attività è riuscita, diventerà 100.
Name
created_at
Type
timestamp
Description
Il timestamp di quando l'attività è stata creata, in millisecondi.
Name
started_at
Type
timestamp
Description
Il timestamp di quando l'attività è stata avviata, in millisecondi.
Name
finished_at
Type
timestamp
Description
Il timestamp di quando l'attività è stata completata, in millisecondi.
Name
expires_at
Type
timestamp
Description
Il timestamp di quando il risultato dell'attività scade, in millisecondi.
Name
preceding_tasks
Type
integer
Description
Il conteggio delle attività precedenti. Significativo solo quando lo stato è PENDING.
Name
task_error
Type
object
Description
Dettagli dell'errore per le attività non riuscite. Vedi Errori per il riferimento completo all'oggetto task_error.
Name
consumed_credits
Type
integer
Description
Il numero di crediti consumati da questa attività. Restituisce 0 per le attività FAILED (i crediti vengono rimborsati in caso di errore).
Name
model_urls
Type
object
Description
URL scaricabili per l'artefatto generato, indicizzati per nome dell'artefatto. Contiene sempre esattamente una voce — il formato richiesto tramite output.format della richiesta di build. La chiave corrisponde al formato richiesto:
- Name
  glb
  Type
  string
  Description
  URL scaricabile per il file GLB. Presente quando output.format era glb (impostazione predefinita).
- Name
  obj
  Type
  string
  Description
  URL scaricabile per un pacchetto zip contenente model.obj, model.mtl e texture.png. Presente quando output.format era obj.
- Name
  bundle_zip
  Type
  string
  Description
  URL scaricabile per un pacchetto zip di ogni artefatto emesso dal generatore. Presente quando output.format era zip.

Example Fridge Magnet Build Task Object

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}