API Testo in 3D

Questo campo deve essere impostato su "preview" quando si crea un'attività di anteprima.

Descrivi che tipo di oggetto è il modello 3D. Massimo 600 caratteri.

Specifica il tipo di Generazione mesh 3D.

Valori disponibili:

• standard: Generazione mesh 3D regolare ad alto dettaglio.
• lowpoly: Genera mesh low-poly ottimizzata per poligoni più puliti.

ID del modello da utilizzare. Valori disponibili: meshy-5, meshy-6, latest (Meshy 6).

Controlla se abilitare la fase di Remesh. Quando impostato su false, l'API restituirà direttamente la mesh triangolare con la massima precisione.

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: Applica la simmetria durante la generazione.

Specifica il pose mode per il modello generato.

Valori disponibili:

• a-pose: Genera il modello in una posa A.
• t-pose: Genera il modello in una posa T.
• "" (stringa vuota): Nessuna posa specifica applicata.

Usa pose_mode al suo posto. Indica se generare il modello in una posa A/T.

Non supportato da Meshy-6. Le richieste che usano Meshy-6 ignoreranno art_style e alcune combinazioni potrebbero causare errori. Valori disponibili: realistic, sculpture.

Quando impostato su true, il contenuto di input verrà automaticamente controllato per individuare contenuti potenzialmente dannosi. Se vengono rilevati contenuti dannosi, l'attività non procederà alla generazione.

Il testo da prompt verrà controllato.

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 dell'attività. Se omesso, vengono inclusi tutti i formati supportati.

Valori disponibili: glb, obj, fbx, stl, usdz, 3mf

Quando impostato su true, l'attività esegue inoltre il rendering di una versione dell'anteprima con sfondo trasparente (RGBA) e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo thumbnail_url esistente rimane invariato.

Quando impostato su true, il servizio usa la visione AI per stimare automaticamente l'altezza reale dell'oggetto e ridimensionare il modello di conseguenza. L'origine verrà impostata per impostazione predefinita su bottom a meno che origin_at non sia impostato esplicitamente.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: Manca un parametro obbligatorio (ad esempio, prompt, mode).
• Parametro non valido: art_style non è uno dei valori consentiti.
• Prompt troppo lungo: Il prompt supera il limite di caratteri.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

Hai superato il tuo limite di frequenza.

Questo campo deve essere impostato su "refine" quando si crea un'attività di perfezionamento.

L'id dell'attività di anteprima corrispondente.

Lo stato dell'attività di anteprima fornita deve essere SUCCEEDED.

Genera mappe PBR (metallica, rugosità, normale) oltre al colore base. È inclusa anche una mappa di emissione quando ai_model è meshy-6 o latest.

Genera la texture del colore base a risoluzione 4K (4096×4096) per un dettaglio maggiore.

Fornisci un prompt testuale aggiuntivo per guidare il processo di applicazione della texture. Massimo 600 caratteri.

Fornisci un'immagine 2D per guidare il processo di applicazione della texture. Attualmente supportiamo i formati .jpg, .jpeg e .png.

Esistono 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>

ID del modello da utilizzare per il perfezionamento. Valori disponibili: meshy-5, meshy-6, latest (Meshy 6).

Quando impostato su true, il contenuto di input verrà automaticamente esaminato per individuare contenuti potenzialmente dannosi. Se viene rilevato contenuto dannoso, l'attività non procederà alla generazione.

Verranno esaminati sia il testo da texture_prompt sia l'immagine da texture_image_url.

Rimuove luci intense e ombre dalla texture del colore base, producendo un risultato più pulito che funziona meglio con configurazioni di illuminazione personalizzate.

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 dell'attività. Se omesso, sono inclusi tutti i formati supportati.

Valori disponibili: glb, obj, fbx, stl, usdz, 3mf

Quando impostato su true, l'attività renderizza inoltre una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo thumbnail_url esistente resta invariato.

Quando impostato su true, il servizio utilizza la visione AI per stimare automaticamente l'altezza reale dell'oggetto e ridimensionare il modello di conseguenza. L'origine sarà impostata su bottom per impostazione predefinita, a meno che origin_at non sia impostato esplicitamente.

La richiesta non era accettabile. Cause comuni:

• ID attività non valido: il preview_task_id non è valido o non esiste.
• Attività non pronta: l'attività di anteprima non è ancora riuscita.
• Mancata corrispondenza del modello: il modello AI dell'attività di anteprima non è compatibile con il modello di perfezionamento richiesto.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

L'attività di anteprima specificata da preview_task_id non è stata trovata.

Hai superato il tuo limite di frequenza.

Identificatore univoco del task Testo in 3D da recuperare.

L'ID dell'attività Testo in 3D da eliminare.

Numero di pagina per la paginazione.

Limite di dimensione della pagina. Il massimo consentito è di 50 elementi.

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.

Identificatore univoco dell'attività Testo in 3D da trasmettere in streaming.

Identificatore univoco per l'attività. Sebbene utilizziamo un UUID k-ordinabile per gli id delle attività come dettaglio implementativo, non dovresti fare alcuna assunzione sul formato dell'id.

Tipo dell'attività Testo in 3D. I valori possibili sono text-to-3d-preview per le attività della fase di anteprima e text-to-3d-refine per le attività della fase di rifinitura.

URL scaricabile del file del modello 3D con texture generato da Meshy. La proprietà per un formato verrà omessa se il formato non viene generato, invece di restituire una stringa vuota.

Questo è il prompt non modificato che è stato utilizzato per creare l'attività.

Mantenuto per compatibilità con le versioni precedenti. Questo campo non ha alcun impatto funzionale sui modelli generati.

Il art_style non modificato che è stato utilizzato per creare l'attività di anteprima. Non supportato da Meshy-6.

Mantenuto per compatibilità con le versioni precedenti. Questo campo non ha alcun impatto funzionale sui modelli generati.

Prompt testuale aggiuntivo fornito per guidare il processo di applicazione delle texture durante la fase di rifinitura.

URL scaricabile dell'immagine texture che è stata utilizzata per guidare il processo di applicazione delle texture.

URL scaricabile dell'immagine di miniatura del file del modello.

URL scaricabile di una versione con sfondo trasparente (RGBA) di thumbnail_url. Presente solo quando l'attività è stata creata con alpha_thumbnail: true e l'anteprima trasparente è stata renderizzata correttamente; in caso contrario questo campo viene omesso.

URL scaricabile del video di anteprima. Verrà rimosso in una versione futura.

Avanzamento dell'attività. Se l'attività non è ancora iniziata, questa proprietà sarà 0. Una volta che l'attività è stata completata con successo, diventerà 100.

Timestamp di quando l'attività è stata avviata, in millisecondi. Se l'attività non è ancora iniziata, questa proprietà sarà 0.

Timestamp di quando l'attività è stata creata, in millisecondi.

Timestamp di quando l'attività è stata completata, in millisecondi. Se l'attività non è ancora completata, questa proprietà sarà 0.

Stato dell'attività. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un array di oggetti URL delle texture generati dall'attività. Normalmente contiene solo un oggetto URL delle texture. Ogni URL delle texture ha le seguenti proprietà:

Il conteggio delle attività precedenti.

Dettagli dell'errore per le attività non riuscite. Vedi Errori per il riferimento completo all'oggetto task_error.

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).