API Multi-immagine in 3D

L'API Multi-immagine in 3D è una funzionalità che ti consente di integrare le capacità di Multi-immagine in 3D di Meshy nella tua applicazione. In questa sezione, troverai tutte le informazioni necessarie per iniziare a utilizzare questa API.

POST/openapi/v1/multi-image-to-3d

Crea un task Multi-immagine in 3D

Questo endpoint consente di creare un nuovo task Multi-immagine in 3D. Consulta L'oggetto task Multi-immagine in 3D per vedere quali proprietà sono incluse nell'oggetto task Multi-immagine in 3D.

Parametri

È richiesto solo uno tra input_task_id o image_urls. Se vengono forniti entrambi, input_task_id ha la priorità.

Name
input_task_id
Type
string
Obbligatorio
Description
L'ID di un task di generazione immagini completato il cui output (1-4 immagini) deve essere usato come input. Questo task deve essere uno dei seguenti: Testo in immagine, Immagine in immagine, Testo in immagine Multi-vista o Immagine in immagine Multi-vista. Inoltre, deve essere stato eseguito tramite l'API e avere lo stato SUCCEEDED.

Name
image_urls
Type
array
Obbligatorio
Description
Fornisci da 1 a 4 immagini che Meshy utilizzerà per la creazione del modello. Attualmente supportiamo i formati .jpg, .jpeg e .png. Tutte le immagini dovrebbero rappresentare lo stesso oggetto da angolazioni diverse per ottenere risultati migliori.
Ci sono due modi per fornire ciascuna immagine:
- URL pubblicamente accessibile: un URL accessibile dalla rete Internet pubblica.
- Data URI: un Data URI dell'immagine codificato in base64. Esempio di Data URI: data:image/jpeg;base64,<i tuoi dati dell'immagine codificati in base64>.
Per meshy-7 (o latest), la prima immagine viene usata come vista primaria (frontale). L'ordine delle immagini rimanenti non ha importanza.

Name
ai_model
Type
string
predefinito latest
Description
ID del modello da utilizzare. Valori disponibili: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
ultra_mode
Type
boolean
predefinito false
Description
Attiva la generazione Ultra per una geometria di maggiore fedeltà con dettagli superficiali più fini.
Supportato solo quando ai_model è meshy-7 (o latest).
Name
should_texture
Type
boolean
predefinito true
Description
Determina se le texture vengono generate. Impostandolo su false si salta la fase di texture, ottenendo una mesh senza texture.

Si applica solo quando should_texture = true

Name
enable_pbr
Type
boolean
predefinito false
Description
Genera mappe PBR (metallica, rugosità, normale) oltre al colore base. Viene inclusa anche una mappa di emissione quando ai_model è meshy-6, eccetto a texture_resolution: 8k. meshy-7 e latest non producono una mappa di emissione.
Name
texture_resolution
Type
string
predefinito 2k
Description
Risoluzione della texture del colore base. Una tra 2k (2048×2048), 4k (4096×4096) o 8k (8192×8192). Risoluzioni più alte catturano maggiori dettagli superficiali.
4k e 8k richiedono ai_model meshy-6, meshy-7 o latest. A 8k, non viene prodotta alcuna mappa di emissione.
Name
hd_texture
Type
boolean
⚠ deprecato
predefinito false
Description
Usa texture_resolution invece — equivalente a texture_resolution: "4k". Quando entrambi sono impostati, texture_resolution ha la precedenza.
Name
texture_prompt
Type
string
Description
Fornisci un prompt testuale per guidare il processo di texturing. Massimo 800 caratteri.
Name
texture_image_url
Type
string
Description
Fornisci un'immagine 2D per guidare il processo di texturing. Attualmente supportiamo i formati .jpg, .jpeg e .png.
Ci sono due modi per fornire l'immagine:
- URL pubblicamente accessibile: un URL accessibile dalla rete Internet pubblica
- Data URI: un Data URI dell'immagine codificato in base64. Esempio di Data URI: data:image/jpeg;base64,<i tuoi dati dell'immagine codificati in base64>
Il texturing basato su immagine potrebbe non funzionare in modo ottimale se ci sono differenze geometriche sostanziali tra l'asset originale e l'immagine caricata. Solo uno tra texture_image_url o texture_prompt può essere usato per guidare il processo di texturing. Se vengono forniti entrambi i parametri, verrà usato texture_prompt per texturizzare il modello per impostazione predefinita.
Name
texture_image_urls
Type
string[]
Description
Fornisci da 1 a 4 immagini che mostrano lo stesso oggetto da viste diverse per guidare il texturing. La prima immagine è la vista primaria (frontale); l'ordine delle viste rimanenti (sinistra, retro, destra) non ha importanza.
Ogni elemento accetta gli stessi formati di texture_image_url (un URL pubblicamente accessibile o un Data URI in base64, .jpg/.jpeg/.png).
Queste immagini guidano solo la texture e sono indipendenti da image_urls — le due liste possono contenere immagini diverse e un numero diverso di immagini.
Richiede ai_model meshy-7 o latest. Non può essere combinato con texture_image_url o texture_prompt.

Name
should_remesh
Type
boolean
predefinito false (meshy-6), true (others)
Description
Controlla se abilitare la fase di remesh. Per il modello di qualità più alta, raccomandiamo di impostare should_remesh su false.

Si applica solo quando should_remesh = true

Name
topology
Type
string
predefinito triangle
Description
Specifica la topology del modello generato.
Valori disponibili:
- quad: genera una mesh a dominanza di quadrilateri.
- triangle: genera una mesh triangolare decimata.
Name
target_polycount
Type
integer
predefinito 30,000
Description
Specifica il numero target di poligoni nel modello generato. Il numero effettivo di poligoni può deviare dal target a seconda della complessità della geometria.
L'intervallo di valori valido varia in base al livello utente:
- da 100 a 300.000 (inclusi)
Name
decimation_mode
Type
integer
Description
Abilita la decimazione adattiva impostando un livello di conteggio poligoni. Quando impostato, target_polycount viene ignorato.
Valori disponibili:
- 1: Adattivo — conteggio poligoni ultra.
- 2: Adattivo — conteggio poligoni alto.
- 3: Adattivo — conteggio poligoni medio.
- 4: Adattivo — conteggio poligoni basso.
Name
save_pre_remeshed_model
Type
boolean
predefinito false
Description
Quando impostato su true, Meshy salva anche un file GLB aggiuntivo prima che la fase di remesh venga completata.

Name
symmetry_mode
Type
string
⚠ deprecato
predefinito auto
Description
Deprecato. Questo parametro non influisce più sull'output.
Il campo symmetry_mode controlla il comportamento della simmetria durante il processo di generazione del modello.
I valori validi sono:
- off: disabilita la simmetria.
- auto: determina e applica automaticamente la simmetria in base alla geometria di input.
- on: impone la simmetria durante la generazione.
Name
pose_mode
Type
string
predefinito ""
Description
Specifica il pose_mode per il modello generato.
Valori disponibili:
- a-pose: genera il modello in posa A.
- t-pose: genera il modello in posa T.
- "" (stringa vuota): nessuna posa specifica applicata.
Name
is_a_t_pose
Type
boolean
⚠ deprecato
predefinito false
Description
Usa pose_mode invece. Indica se generare il modello in posa A/T.
Name
image_enhancement
Type
boolean
predefinito true
Description
Ottimizza le immagini di input per risultati migliori. Imposta su false per preservare l'aspetto esatto delle immagini di input senza alcuna elaborazione stilistica.
Supportato solo quando ai_model è meshy-6, meshy-7 o latest.
Name
remove_lighting
Type
boolean
predefinito true
Description
Rimuove luci e ombre dalla texture del colore base, producendo un risultato più pulito che funziona meglio con configurazioni di illuminazione personalizzate.
Supportato solo quando ai_model è meshy-6, meshy-7 o latest.
Name
moderation
Type
boolean
predefinito false
Description
Quando impostato su true, il contenuto di input verrà automaticamente controllato per individuare eventuali contenuti potenzialmente dannosi. Se viene rilevato contenuto dannoso, il task non procederà con la generazione.
Verranno controllate ciascuna immagine di image_urls e il testo di texture_prompt.
Name
target_formats
Type
string[]
Description
Specifica quali formati di file 3D includere nell'output. Verranno generati e restituiti solo i formati richiesti, il che può ridurre il tempo di completamento del task.
Valori disponibili: glb, obj, fbx, stl, usdz, 3mf
Se omesso, vengono generati tutti i formati eccetto 3mf. 3mf viene incluso solo quando specificato esplicitamente.
Name
auto_size
Type
boolean
predefinito false
Description
Quando impostato su true, il servizio utilizza la visione artificiale per stimare automaticamente l'altezza reale dell'oggetto e ridimensionare il modello di conseguenza. L'origine sarà impostata di default su bottom a meno che origin_at non venga esplicitamente impostato.
Name
alpha_thumbnail
Type
boolean
predefinito false
Description
Quando impostato su true, il task renderizza inoltre una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo esistente thumbnail_url rimane invariato.
Name
multi_view_thumbnails
Type
boolean
predefinito false
Description
Quando impostato su true, il task renderizza inoltre quattro miniature con vista cardinale (frontale, destra, retro, sinistra) e le restituisce sotto thumbnail_urls nella risposta GET. Il campo esistente thumbnail_url rimane invariato e continua a puntare alla vista frontale, quindi i client esistenti non ne sono influenzati.
Aggiunge circa 3 secondi alla latenza del task.

Si applica solo quando auto_size = true

Name
origin_at
Type
string
predefinito bottom
Description
Posizione dell'origine quando auto_size è abilitato. Valori disponibili: bottom, center.

Valori restituiti

La proprietà result della risposta contiene l'id del task del nuovo task Multi-immagine in 3D creato.

Modalità di errore

Name
400 - Bad Request
Description
La richiesta non era accettabile. Cause comuni:
- Parametro mancante: deve essere fornito image_urls oppure input_task_id.
- Task di input non valido: input_task_id deve fare riferimento a un task Testo in immagine, Immagine in immagine o a una variante multi-vista con stato SUCCEEDED.
- Numero di immagini non valido: image_urls deve contenere tra 1 e 4 immagini, e texture_image_urls tra 1 e 4.
- Formato immagine non valido: una o più immagini in image_urls non sono in formati supportati.
- Input di texture in conflitto: texture_image_urls non può essere combinato con texture_image_url o texture_prompt, e richiede should_texture: true.
- Modello non supportato per la texture multi-vista: texture_image_urls richiede ai_model meshy-7 o latest.
- URL non raggiungibile: uno o più elementi di image_urls o texture_image_urls non è stato possibile scaricarli.
Name
401 - Unauthorized
Description
Autenticazione non riuscita. Controlla la tua chiave API.
Name
402 - Payment Required
Description
Crediti insufficienti per eseguire questo task.
Name
429 - Too Many Requests
Description
Hai superato il tuo limite di frequenza.

Request

POST

/openapi/v1/multi-image-to-3d

# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# With PBR texturing and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

Response

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

GET/openapi/v1/multi-image-to-3d/:id

Recupera un'attività Multi-immagine in 3D

Questo endpoint ti permette di recuperare un'attività Multi-immagine in 3D dato un valido id dell'attività. Consulta L'oggetto Attività Multi-immagine in 3D per vedere quali proprietà sono incluse con l'oggetto attività Multi-immagine in 3D.

Parametri

Name
id
Type
path
Description
Identificatore univoco per l'attività Multi-immagine in 3D da recuperare.

Restituisce

La risposta contiene l'oggetto attività Multi-immagine in 3D. Controlla la sezione L'oggetto Attività Multi-immagine in 3D per i dettagli.

Richiesta

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Risposta

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

DELETE/openapi/v1/multi-image-to-3d/:id

Elimina un'attività Multi-immagine in 3D

Questo endpoint elimina permanentemente un'attività Multi-immagine in 3D, inclusi tutti i modelli e i dati associati. Questa azione è irreversibile.

Parametri del percorso

Name
id
Type
path
Description
L'ID dell'attività Multi-immagine in 3D da eliminare.

Restituisce

Restituisce 200 OK in caso di successo.

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 200 Ok on success.

GET/openapi/v1/multi-image-to-3d

Elenco delle attività Multi-immagine in 3D

Questo endpoint ti consente di recuperare un elenco di attività Multi-immagine in 3D.

Parametri

Attributi opzionali

Name
page_num
Type
integer
Description
Numero di pagina per la paginazione. Inizia e predefinito a 1.
Name
page_size
Type
integer
Description
Limite della dimensione della pagina. Predefinito a 10 elementi. Il massimo consentito è 50 elementi.
Name
sort_by
Type
string
Description
Campo per l'ordinamento. Valori disponibili:
- +created_at: Ordina per tempo di creazione in ordine crescente.
- -created_at: Ordina per tempo di creazione in ordine decrescente.

Restituisce

Restituisce un elenco paginato di Gli oggetti attività Multi-immagine in 3D.

Richiesta

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Risposta

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

GET/openapi/v1/multi-image-to-3d/:id/stream

Stream di un'attività Multi-immagine in 3D

Questo endpoint trasmette aggiornamenti in tempo reale per un'attività Multi-immagine in 3D utilizzando Server-Sent Events (SSE).

Parametri

Name
id
Type
path
Description
Identificatore univoco per l'attività Multi-immagine in 3D da trasmettere.

Restituisce

Restituisce un flusso di Oggetti dell'attività Multi-immagine in 3D come Server-Sent Events.

Per attività PENDING o IN_PROGRESS, il flusso di risposta includerà solo i campi necessari progress e status.

Richiesta

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Flusso di Risposta

// Error event example
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": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
  "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
  "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
  "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

L'oggetto Task Multi-immagine in 3D

L'oggetto Task Multi-immagine in 3D è un'unità di lavoro che Meshy tiene traccia per generare un modello 3D a partire da più immagini (da 1 a 4 incluse). Le immagini devono raffigurare lo stesso oggetto, idealmente da viste o angolazioni diverse. L'oggetto ha le seguenti proprietà:

Proprietà

Name
id
Type
string
Description
Identificatore univoco per il task. Sebbene per gli id dei task venga utilizzato come dettaglio implementativo un UUID k-sortable, non dovresti fare alcuna assunzione riguardo al formato dell'id.
Name
type
Type
string
Description
Tipo del task Multi-immagine in 3D. Il valore è multi-image-to-3d.
Name
model_urls
Type
object
Description
URL scaricabile del file del modello 3D texturizzato generato da Meshy. La proprietà relativa a un formato verrà omessa se il formato non è stato generato, invece di restituire una stringa vuota.
- Name
  glb
  Type
  string
  Description
  URL scaricabile del file GLB.
- Name
  fbx
  Type
  string
  Description
  URL scaricabile del file FBX.
- Name
  obj
  Type
  string
  Description
  URL scaricabile del file OBJ.
- Name
  usdz
  Type
  string
  Description
  URL scaricabile del file USDZ.
- Name
  mtl
  Type
  string
  Description
  URL scaricabile del file MTL, restituito insieme alle esportazioni OBJ quando sono presenti texture.
- Name
  stl
  Type
  string
  Description
  URL scaricabile del file STL.
- Name
  3mf
  Type
  string
  Description
  URL scaricabile del file 3MF. Presente solo quando 3mf è stato richiesto tramite target_formats.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  URL scaricabile del file GLB originale prima del remesh.
  Disponibile solo quando il task è stato creato sia con should_remesh: true sia con save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
URL scaricabile dell'immagine miniatura del file del modello. Equivalente a thumbnail_urls.front quando presente, mantenuto per compatibilità con le versioni precedenti.
Name
alpha_thumbnail_url
Type
string
Description
URL scaricabile di una versione con sfondo trasparente (RGBA) di thumbnail_url. Presente solo quando il task è stato creato con alpha_thumbnail: true e l'anteprima trasparente è stata renderizzata con successo; altrimenti questo campo viene omesso.
Name
thumbnail_urls
Type
object
Description
URL scaricabili per quattro miniature con viste cardinali del modello 3D generato. Ogni valore è un URL firmato di un'immagine PNG 512×512 renderizzata con gli stessi materiali e la stessa illuminazione di thumbnail_url. Utile per visualizzare in anteprima il modello da più angolazioni in pipeline batch senza scaricare il GLB.
Presente solo quando il task è stato creato con multi_view_thumbnails: true e ha raggiunto lo stato SUCCEEDED. I task più vecchi e quelli creati senza questa opzione attivata non includeranno questo campo.
- Name
  front
  Type
  string
  Description
  Vista frontale, rotazione di 0° attorno all'asse verticale (corrisponde a thumbnail_url).
- Name
  right
  Type
  string
  Description
  Vista destra, rotazione di 90°.
- Name
  back
  Type
  string
  Description
  Vista posteriore, rotazione di 180°.
- Name
  left
  Type
  string
  Description
  Vista sinistra, rotazione di 270°.
Name
texture_prompt
Type
string
Description
Il prompt testuale utilizzato per guidare il processo di texturizzazione.
Name
texture_image_urls
Type
string[]
Description
URL scaricabili delle immagini di riferimento per la texture utilizzate per creare il task, nell'ordine in cui sono state fornite. Presente solo quando il task è stato creato con texture_image_urls.
Name
ultra_mode
Type
boolean
Description
Riflette il valore di ultra_mode con cui il task è stato creato. Presente solo per i task meshy-7 (o latest) che impostano esplicitamente ultra_mode; omesso altrimenti.
Name
progress
Type
integer
Description
Avanzamento del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task ha avuto successo, questa proprietà diventerà 100.
Name
started_at
Type
timestamp
Description
Timestamp di quando il task è stato avviato, in millisecondi. Se il task non è ancora iniziato, questa proprietà sarà 0.
Un timestamp rappresenta il numero di millisecondi trascorsi dal 1° gennaio 1970 UTC, seguendo lo standard RFC 3339. Ad esempio, venerdì 1 settembre 2023 alle 12:00:00 GMT è rappresentato come 1693569600000. Questo si applica a tutti i timestamp in Meshy API.
Name
created_at
Type
timestamp
Description
Timestamp di quando il task è stato creato, in millisecondi.
Name
expires_at
Type
timestamp
Description
Timestamp di quando il risultato del task scade, in millisecondi.
Name
finished_at
Type
timestamp
Description
Timestamp di quando il task è stato completato, in millisecondi. Se il task non è ancora terminato, questa proprietà sarà 0.
Name
status
Type
string
Description
Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
Un array di oggetti URL delle texture generate dal task. Normalmente contiene un solo oggetto URL della texture. Ogni URL della texture ha le seguenti proprietà:
- Name
  base_color
  Type
  string
  Description
  URL scaricabile dell'immagine della mappa del colore base.
- Name
  metallic
  Type
  string
  Description
  URL scaricabile dell'immagine della mappa metallica.
  Se il task è stato creato con enable_pbr: false, questa proprietà verrà omessa.
- Name
  normal
  Type
  string
  Description
  URL scaricabile dell'immagine della normal map.
  Se il task è stato creato con enable_pbr: false, questa proprietà verrà omessa.
- Name
  roughness
  Type
  string
  Description
  URL scaricabile dell'immagine della mappa di rugosità.
  Se il task è stato creato con enable_pbr: false, questa proprietà verrà omessa.
- Name
  emission
  Type
  string
  Description
  URL scaricabile dell'immagine della mappa di emissione.
  Se il task è stato creato con enable_pbr: false, oppure ai_model è meshy-5, questa proprietà verrà omessa.
Name
preceding_tasks
Type
integer
Description
Il numero di task precedenti.
Il valore di questo campo è significativo solo se lo stato del task è PENDING.
Name
task_error
Type
object
Description
Dettagli dell'errore per i task falliti. Vedi Errori per il riferimento completo dell'oggetto task_error.
Name
consumed_credits
Type
integer
Description
Il numero di crediti consumati da questo task. Presente quando lo stato del task è PENDING, IN_PROGRESS o SUCCEEDED. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30,
}