Retexture API
Genera nuove texture per un modello 3D esistente a partire da un prompt testuale o da immagini di riferimento. Il modello può provenire da un altro task di Meshy o da un file di modello.
Crea un task di Retexture
Crea un task di Retexture. Il task viene eseguito in background. Per sapere quanto tempo richiede di solito un task, vedi Tempi di elaborazione.
Request
# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"enable_original_uv": true,
"enable_pbr": true
}'
# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
"image_style_url": "<your publicly accessible image url or base64-encoded data URI>",
"ai_model": "latest",
"enable_pbr": true,
"enable_original_uv": true
}'
# Retexture with Meshy N1 from front and back views
curl https://api.meshy.ai/openapi/v1/retexture \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
"ai_model": "meshy-n1",
"multiview_image_urls": [
"<your front view image url or data URI>",
"<your back view image url or data URI>"
]
}'
Response
{
"result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
Parametri
- Name
- input_task_id
- Type
- string
- Obbligatorio
- Description
Obbligatorio a meno che tu invii
model_url. L'ID di un task che ha prodotto un modello 3D da texturizzare, ad esempio un task Testo in 3D, Immagine in 3D, Remesh o Retexture. Il task deve essere uno che hai creato con l'API e avere lo statoSUCCEEDED. Meshy applica la texture al GLB del task.Con
meshy-n1, il modello del task può avere al massimo 7.999.999 facce, contate come triangoli (un quadrilatero conta come 2).
- Name
- model_url
- Type
- string
- Obbligatorio
- Description
Obbligatorio a meno che tu invii
input_task_id. Il modello da texturizzare, come URL pubblico o data URI. Se invii entrambi, Meshy usainput_task_id.Il modello deve essere un file GLB, glTF, OBJ, FBX o STL di al massimo 400 MB da un URL
httpohttps, oppure di 100 MB come data URI. Per un data URI, usa il MIME typeapplication/octet-stream, ad esempiodata:application/octet-stream;base64,<i tuoi dati del modello codificati in base64>.Un file oltre 100 MB deve anche seguire queste regole:
- Un file GLB, glTF, FBX o OBJ può avere al massimo 10.000.000 di facce. Meshy conta le facce come triangoli, quindi un quadrilatero conta come 2, e una mesh disegnata più volte conta una volta per copia.
- Un file FBX deve essere FBX binario 7.1 o più recente.
- Un file GLB o glTF non deve usare la compressione Draco.
Con
meshy-n1, il modello può avere al massimo 7.999.999 facce, contate come triangoli (un quadrilatero conta come 2), indipendentemente dalla dimensione del file.
Invia uno di questi tre input di stile.
- Name
- text_style_prompt
- Type
- string
- Obbligatorio
- Description
Obbligatorio a meno che tu invii
image_style_urlomultiview_image_urls. Testo che descrive la texture desiderata, fino a 800 caratteri. Un testo più lungo restituisce400. Conmeshy-n1, inviarlo senzaimage_style_urlrestituisce400.
- Name
- image_style_url
- Type
- string
- Obbligatorio
- Description
Obbligatorio a meno che tu invii
text_style_promptomultiview_image_urls. Un'immagine 2D il cui stile la texture segue, come URL pubblico o data URI (data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>). Se invii siatext_style_promptcheimage_style_url, Meshy usaimage_style_url.L'immagine deve essere un file
.jpg,.jpeg,.pngo.webpdi al massimo 20 MB, e di almeno 32 pixel per lato.La texture potrebbe non adattarsi bene quando l'oggetto nell'immagine ha una forma molto diversa dal modello. Con
meshy-n1, Meshy tratta l'immagine come la vista frontale.
- Name
- multiview_image_urls
- Type
- string[]
- Obbligatorio
- Description
Obbligatorio a meno che tu invii
text_style_promptoimage_style_url. Da una a quattro immagini dello stesso oggetto da viste diverse. La prima immagine è la vista principale (frontale). L'ordine delle altre viste (sinistra, retro, destra) non è rilevante. Un array vuoto, o più di quattro immagini, restituisce400.Ogni immagine segue le stesse regole di formato e dimensione di
image_style_url, al massimo 20 MB per immagine. Non puoi combinaremultiview_image_urlscontext_style_promptoimage_style_url.multiview_image_urlsrichiede unai_modelesplicito pari ameshy-7omeshy-n1. Qualsiasi altroai_model, incluso il predefinitolatest, restituisce400.
- Name
- ai_model
- Type
- string
- predefinito latest
- Description
Il modello AI che genera la texture.
Valori disponibili:
meshy-6-litemeshy-6meshy-7meshy-n1: una texture a colore base 2K solo da immagini di riferimento. Nessun prompt testuale, nessuna mappa PBR, nessun 4K o 8K. Fino a 7.999.999 facce.latest: Meshy 7
- Name
- enable_original_uv
- Type
- boolean
- predefinito false
- Description
Se mantenere il layout UV del modello invece di generarne uno nuovo.
- Per un modello generato da Meshy, da
input_task_ido da unmodel_urlche punta a un output di Meshy, usatrueper riutilizzare il suo layout UV ottimizzato. - Per un modello caricato da altrove, usa
trueper mantenere UV già buone. Lascialofalseper permettere a Meshy di generare nuove UV, adatto a un modello senza una corretta mappatura UV.
- Per un modello generato da Meshy, da
- Name
- enable_pbr
- Type
- boolean
- predefinito false
- Description
Se generare anche mappe PBR (metallico, ruvidità e normali) insieme al colore base. Con
meshy-6, Meshy genera anche una mappa di emissione, tranne che a unatexture_resolutiondi8k.meshy-6-lite,meshy-7elatestnon generano una mappa di emissione. Conmeshy-n1,truerestituisce400.
- Name
- texture_resolution
- Type
- string
- predefinito 2k
- Description
La dimensione della texture del colore base. Risoluzioni più alte catturano più dettagli di superficie.
Valori disponibili:
2k: 2048 × 2048 pixel4k: 4096 × 4096 pixel8k: 8192 × 8192 pixel
4ke8krichiedono unai_modelpari ameshy-6,meshy-7olatest. Conmeshy-6-liteomeshy-n1, restituiscono400. A8k, Meshy non genera una mappa di emissione.
- Name
- hd_texture
- Type
- boolean
- ⚠ deprecato
- predefinito false
- Description
Usa invece
texture_resolution.trueequivale atexture_resolution: "4k". Se invii entrambi, Meshy usatexture_resolution.
- Name
- remove_lighting
- Type
- boolean
- predefinito true
- Description
Se rimuovere luci e ombre dalla texture del colore base. Il risultato funziona meglio con la tua illuminazione.
Meshy lo applica solo con
meshy-6, a unatexture_resolutiondi2ko4k. Conmeshy-7olatest, o a8k, Meshy lo accetta e lo ignora. Conmeshy-6-liteomeshy-n1, inviarlo con qualsiasi valore restituisce400.
- Name
- target_formats
- Type
- string[]
- Description
I formati di file da generare. Meshy genera solo i formati elencati, il che può ridurre la durata del task. Se lo ometti, Meshy genera ogni formato tranne
3mf.Valori disponibili:
glbobjfbxstlusdz3mf
- Name
- alpha_thumbnail
- Type
- boolean
- predefinito false
- Description
Se renderizzare anche un'anteprima con sfondo trasparente (RGBA), restituita in
alpha_thumbnail_urlquando ottieni il task.thumbnail_urlnon cambia.
Restituisce
Il campo result della risposta contiene l'ID del nuovo task di Retexture.
Modalità di fallimento
- Name
400 - Bad Request- Description
La richiesta non può essere eseguita. Il messaggio di errore indica quale problema ha riscontrato. Ad esempio:
- Parametro mancante: Non è stato inviato né
model_urlnéinput_task_id. - Stile mancante: Non è stato inviato nessuno tra
text_style_prompt,image_style_urlemultiview_image_urls. - Input di stile in conflitto:
multiview_image_urlsè stato inviato insieme atext_style_promptoimage_style_url. - Modello non supportato per multi-vista:
multiview_image_urlsè stato inviato senza unai_modelesplicito pari ameshy-7omeshy-n1. - Opzione non supportata per Meshy N1:
meshy-n1è stato inviato conenable_pbr: true,remove_lighting, unatexture_resolutiondi4ko8k,hd_texture: truesenzatexture_resolution, otext_style_promptsenzaimage_style_url. - Troppi triangoli per Meshy N1: Con
meshy-n1, il modello 3D ha più di 7.999.999 triangoli. Riduci il numero di triangoli, oppure usa un altroai_model. - Modello troppo complesso per Meshy N1: Con
meshy-n1, il file dimodel_urlè troppo complesso perché Meshy ne possa contare i triangoli. Riduci il numero di triangoli, poi invia di nuovo il file. - Conteggio triangoli scaduto: Con
meshy-n1, il conteggio dei triangoli del file dimodel_urlha richiesto troppo tempo. Riprova, oppure riduci la dimensione del modello. - Task di input non valido:
input_task_idnon è un task riuscito di un tipo supportato. - Formato del modello non valido: Il file di
model_urlha un'estensione non supportata. - URL irraggiungibile: Meshy non riesce a scaricare il file di
model_url, l'immagine diimage_style_url, o un'immagine dimultiview_image_urls. - File del modello troppo grande: Il file di
model_urlsupera i 400 MB da un URLhttpohttps, oppure i 100 MB come data URI. - Troppe facce: Il file di
model_urlsupera i 100 MB e ha più di 10.000.000 di facce. Riduci il numero di facce, poi invia di nuovo il file. - FBX ASCII oltre 100 MB: Il file di
model_urlè un FBX ASCII oltre 100 MB. Inviarlo come FBX binario o GLB. - File del modello illeggibile: Il file di
model_urlsupera i 100 MB e Meshy non riesce a leggerne l'header. Ad esempio, è un GLB o glTF compresso con Draco, o un FBX binario antecedente alla 7.1. - Header del modello troppo complesso: Il file di
model_urlsupera i 100 MB, e il suo header ha troppe mesh, nodi o record da controllare. Riduci il numero di oggetti nel file, poi invialo di nuovo. - Immagine troppo grande: L'immagine di
image_style_urlo un'immagine dimultiview_image_urlssupera i 20 MB.
Con
meshy-n1, un modello che Meshy non può controllare prima dell'avvio del task, ad esempio un file STL, non viene rifiutato in questa fase. Se ha più di 7.999.999 triangoli, il task fallisce e Meshy rimborsa i crediti relativi.Correggi la richiesta, poi invia di nuovo. Vedi Errori.
- Parametro mancante: Non è stato inviato né
- Name
401 - Unauthorized- Description
La chiave API è mancante o non valida. Controlla l'header
Authorization.
- Name
402 - Payment Required- Description
Ad esempio:
- Crediti insufficienti: L'account non ha crediti sufficienti per questo task, oppure l'account ha raggiunto un limite di crediti. Controlla il tuo saldo crediti, poi riprova.
- Piano gratuito: Creare un task richiede un piano a pagamento. Aggiorna il tuo piano nelle impostazioni dell'abbonamento, poi riprova.
- Name
403 - Forbidden- Description
Si applica uno di questi casi:
- La moderation dei contenuti ha bloccato il prompt o un'immagine di input. Modifica l'input, poi riprova.
input_task_idè un modello bassorilievo, che questo endpoint non può retexturizzare. Il messaggio èThis model type does not support this operation. Invia un modello diverso.
- Name
404 - Not Found- Description
input_task_idnon corrisponde a nessuno dei tuoi task. Controlla l'ID del task, poi invia di nuovo la richiesta.
- Name
429 - Too Many Requests- Description
Hai superato il tuo limite di frequenza. Attendi, poi riprova. Vedi Limiti di frequenza.
Ottieni un task Retexture
Restituisce un task Retexture tramite il suo ID.
Request
curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"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=***",
"mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"texture_image_url": "",
"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"
}
],
"task_error": null,
"consumed_credits": 10
}
Parametri
- Name
- id
- Type
- path
- Description
L'ID del task dalla risposta di creazione.
Restituisce
Elimina un'attività Retexture
Elimina permanentemente un'attività Retexture, inclusi i suoi modelli e dati. Non puoi annullare un'eliminazione.
Request
curl --request DELETE \
--url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
"message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}
Parametri del percorso
- Name
- id
- Type
- path
- Description
L'ID dell'attività da eliminare.
Stato dell'attività
Eliminare un'attività PENDING rimborsa i crediti usati per crearla.
Un'attività IN_PROGRESS non può essere eliminata. La richiesta restituisce 409 Conflict,
e l'attività continua a essere eseguita. Meshy non rimborsa un'attività già avviata,
quindi eliminarla ti costerebbe sia i crediti che il risultato. Attendi che
raggiunga lo stato SUCCEEDED, FAILED, o CANCELED, quindi eliminala.
Eliminare un'attività in uno stato finale (SUCCEEDED, FAILED, o CANCELED)
non rimborsa i suoi crediti.
Restituisce
200 OK quando l'attività viene eliminata, oppure 409 Conflict quando l'attività è
IN_PROGRESS.
Elenca le attività di Retexture
Restituisce un elenco delle tue attività di Retexture.
Request
curl https://api.meshy.ai/openapi/v1/retexture?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
[
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"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=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"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"
}
],
"task_error": null,
"consumed_credits": 10
}
]
Parametri
- Name
- page_num
- Type
- integer
- predefinito 1
- Description
Il numero di pagina da restituire, fino a
255. Un valore maggiore restituisce400.
- Name
- page_size
- Type
- integer
- predefinito 10
- Description
Il numero di attività per pagina, fino a
100.
- Name
- sort_by
- Type
- string
- Description
L'ordine di ordinamento.
Valori disponibili:
+created_at: prima le più vecchie-created_at: prima le più recenti
Restituisce
Un elenco paginato di oggetti attività Retexture.
Trasmetti in streaming un task di Retexture
Trasmette in streaming gli aggiornamenti di un task di Retexture come Server-Sent Events (SSE).
Request
curl -N https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response Stream
// Error event example
event: error
data: {
"status_code": 404,
"message": "Task not found"
}
// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"progress": 0,
"status": "PENDING"
}
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"progress": 50,
"status": "IN_PROGRESS"
}
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"progress": 100,
"status": "SUCCEEDED",
"created_at": 1692771650657,
"started_at": 1692771667037,
"finished_at": 1692771669037,
"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=***",
"mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
},
"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"
}
],
"task_error": null,
"consumed_credits": 10
}
Parametri
- Name
- id
- Type
- path
- Description
L'ID del task dalla risposta di creazione.
Restituisce
Un flusso di oggetti task Retexture come Server-Sent Events.
Ogni evento contiene l'oggetto task completo, nello stesso formato restituito dall'endpoint Get. Mentre il task è PENDING o IN_PROGRESS, i suoi campi di risultato non hanno ancora valori.
L'oggetto task Retexture
Un oggetto task Retexture descrive un'operazione di retexture di un modello 3D. Contiene lo stato, il progresso e i file del modello e delle texture quando il task ha esito positivo.
Proprietà
Example Retexture Task Model
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "retexture",
"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=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
},
"text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
"image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"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"
}
],
"task_error": null,
"consumed_credits": 10
}
- Name
- id
- Type
- string
- Description
L'ID del task. Trattalo come una stringa opaca e non fare affidamento sul suo formato.
- Name
- type
- Type
- string
- Description
Il tipo di task, sempre
retexture.
- Name
- model_urls
- Type
- object
- Description
URL di download per il modello 3D con texture, uno per ogni formato di file.
- Name
glb- Type
- string
- Description
Il file GLB.
- Name
fbx- Type
- string
- Description
Il file FBX.
- Name
obj- Type
- string
- Description
Il file OBJ.
- Name
usdz- Type
- string
- Description
Il file USDZ.
- Name
mtl- Type
- string
- Description
Il file MTL. Meshy lo restituisce insieme al file OBJ quando il modello ha texture.
- Name
stl- Type
- string
- Description
Il file STL.
- Name
3mf- Type
- string
- Description
Il file 3MF. Presente solo quando
target_formatsinclude3mf.
- Name
- text_style_prompt
- Type
- string
- Description
Il prompt testuale con cui hai creato il task.
- Name
- image_style_url
- Type
- string
- Description
L'immagine di stile con cui hai creato il task.
- Name
- multiview_image_urls
- Type
- string[]
- Description
URL di download per le immagini di riferimento multi-vista con cui hai creato il task. Presente solo quando hai creato il task con
multiview_image_urls.
- Name
- thumbnail_url
- Type
- string
- Description
URL di download per un'immagine in miniatura del modello.
- Name
- alpha_thumbnail_url
- Type
- string
- Description
URL di download per una versione di
thumbnail_urlcon sfondo trasparente (RGBA). Presente solo quando hai creato il task conalpha_thumbnail: truee Meshy ha renderizzato l'anteprima trasparente.
- Name
- progress
- Type
- integer
- Description
Quanta parte del task è stata completata, in percentuale. È
0finché il task non inizia ed è100quando ha esito positivo.
- Name
- started_at
- Type
- timestamp
- Description
Momento in cui il task è iniziato, in millisecondi Unix. È
0finché il task non inizia.
- Name
- created_at
- Type
- timestamp
- Description
Momento in cui il task è stato creato, in millisecondi Unix.
- Name
- expires_at
- Type
- timestamp
- Description
Momento in cui i risultati del task scadono, in millisecondi Unix.
- Name
- finished_at
- Type
- timestamp
- Description
Momento in cui il task è terminato, in millisecondi Unix. È
0finché il task non termina.
- Name
- status
- Type
- string
- Description
Lo stato del task, uno tra
PENDING,IN_PROGRESS,SUCCEEDED,FAILEDoCANCELED.
- Name
- texture_urls
- Type
- array
- Description
URL di download per le texture generate, come array di oggetti. L'array di solito contiene un solo oggetto. Ogni oggetto ha questi campi:
- Name
base_color- Type
- string
- Description
URL di download per la mappa del colore di base.
- Name
metallic- Type
- string
- Description
URL di download per la mappa metallica. Meshy omette questo campo quando crei il task con
enable_pbr: false.
- Name
normal- Type
- string
- Description
URL di download per la normal map. Meshy omette questo campo quando crei il task con
enable_pbr: false.
- Name
roughness- Type
- string
- Description
URL di download per la mappa di rugosità. Meshy omette questo campo quando crei il task con
enable_pbr: false.
- Name
emission- Type
- string
- Description
URL di download per la mappa di emissione. Meshy omette questo campo quando crei il task con una di queste condizioni:
enable_pbr: false- un
ai_modelpari ameshy-6-lite,meshy-7olatest texture_resolution: 8k
- Name
- preceding_tasks
- Type
- integer
- Description
Il numero di task davanti a questo nella coda. Presente solo mentre il task è
PENDING; il campo viene omesso quando il valore è0.
- Name
- task_error
- Type
- object
- Description
I dettagli dell'errore quando il task fallisce. Vedi Errori.
- Name
- consumed_credits
- Type
- integer
- Description
Il numero di crediti utilizzati dal task. Presente quando lo stato è
PENDING,IN_PROGRESSoSUCCEEDED. È0per un taskFAILED, perché Meshy rimborsa i crediti quando un task fallisce.