Creative Lab — API Brick Figure

Foto sorgente che Meshy stilizzerà come minifigure in mattoncini. 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 pubblicamente.
• Data URI: un data URI dell'immagine codificato in base64. Esempio di data URI: data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>.

Nome opzionale del task per scopi di visualizzazione. Massimo 100 caratteri.

Quando impostato su true, l'immagine del prototipo viene restituita come PNG RGBA trasparente con lo sfondo rimosso, così puoi comporre il soggetto su qualsiasi sfondo.

La richiesta non è stata accettata. 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 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 image_url (404 o timeout).
• Data URI non valido: la stringa base64 è malformata.
• Contenuto segnalato: l'immagine di input è stata segnalata dalla moderation NSFW.

Autenticazione fallita. Verifica la tua chiave API.

Crediti insufficienti per eseguire questo task.

L'immagine di input è stata segnalata per violazione della proprietà intellettuale.

Hai superato il limite di frequenza.

L'ID del task di un task di prototipo creato tramite questo stesso endpoint OpenAPI. Il prototipo deve essere stato creato con la stessa chiave API, deve aver raggiunto lo stato SUCCEEDED e deve aver prodotto esattamente un'immagine candidata.

I task di prototipo creati tramite la webapp non sono accettati: l'endpoint di build accetta solo i task di prototipo prodotti da POST /openapi/creative-lab/brick-figure/v1/prototype e rifiuta qualsiasi altra origine con 404.

Nome del task opzionale a scopo di visualizzazione. Massimo 100 caratteri.

La richiesta non è stata accettata. Cause comuni:

• Parametro mancante: input_task_id è obbligatorio.
• UUID non valido: input_task_id non è un UUID valido.
• Il parent non è riuscito: il task di prototipo referenziato non ha ancora raggiunto lo stato SUCCEEDED.
• Nessun candidato: il task di prototipo è riuscito ma non ha prodotto alcuna immagine candidata.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questo task.

Il task di prototipo referenziato non esiste, appartiene a un altro utente o è stato creato tramite la webapp (solo i task di prototipo in modalità API possono essere concatenati al build).

Hai superato il tuo limite di frequenza.

Identificatore univoco dell'attività di statuina Brick Figure da recuperare.

Identificatore univoco del task di brick figure da annullare.

Il task si trova già in uno stato terminale e non può essere annullato.

Il task non esiste, appartiene a un altro utente, oppure il suo stage non corrisponde al percorso URL.

Identificatore univoco dell'attività brick figure di cui effettuare lo streaming.

Può essere prototype o build. La raccolta restituisce solo i task la cui fase corrisponde all'URL — richiedere /prototype non restituisce mai task di build e viceversa.

Numero di pagina per la paginazione.

Limite di elementi per pagina. Il massimo consentito è 100 elementi.

Campo su cui ordinare. Valori disponibili:

• +created_at: Ordina per data di creazione in ordine crescente.
• -created_at: Ordina per data di creazione in ordine decrescente.

Identificatore univoco del task. Sebbene per gli id dei task venga utilizzato, come dettaglio implementativo, un UUID k-sortable, non si dovrebbero fare assunzioni sul formato dell'id.

Tipo del task. Il valore è creative-lab-brick-figure-prototype.

Il nome del task fornito al momento della creazione del task. Stringa vuota se non è stato fornito alcun nome.

Stato del task. I possibili valori sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progresso del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è andato a buon fine, diventerà 100.

Timestamp di quando il task è stato creato, in millisecondi.

Timestamp di quando il task è stato avviato, in millisecondi. Se il task non è ancora stato avviato, questa proprietà sarà null.

Timestamp di quando il task è stato completato, in millisecondi. Se il task non è ancora stato completato, questa proprietà sarà null.

Timestamp di quando il risultato del task scade, in millisecondi.

Il numero di task precedenti.

Dettagli dell'errore per i task falliti. Vedere Errori per il riferimento completo all'oggetto task_error.

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

URL scaricabili per i candidati dell'immagine concettuale generati da questo task di prototipazione. Attualmente l'API restituisce sempre esattamente un candidato; il campo è un array in modo che revisioni future possano esporre più candidati senza introdurre modifiche non retrocompatibili.

Identificatore univoco per il task.

Tipo del task. Il valore è creative-lab-brick-figure-build.

Il nome del task fornito al momento della creazione. Stringa vuota se non è stato fornito alcun nome.

Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progress del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è riuscito, diventerà 100.

Timestamp di quando il task è stato creato, in millisecondi.

Timestamp di quando il task è stato avviato, in millisecondi.

Timestamp di quando il task è stato completato, in millisecondi.

Timestamp di quando il risultato del task scade, in millisecondi.

Il numero di task precedenti. Significativo solo quando lo status è PENDING.

Dettagli dell'errore per i task falliti. Consulta Errori per il riferimento completo dell'oggetto task_error.

Il numero di crediti consumati da questo task. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

Sempre vuoto per il brick figure build. Presente per compatibilità cross-endpoint con la struttura condivisa V2ImageTo3DTaskResponse utilizzata da Immagine in 3D.

Sempre vuoto per il brick figure build. Presente per compatibilità cross-endpoint.

Sempre vuoto per il brick figure build. Presente per compatibilità cross-endpoint.

Sempre vuoto per il brick figure build. Presente per compatibilità cross-endpoint.

URL scaricabili per il modello 3D generato. Il brick figure build produce un GLB con texture più la coppia OBJ + MTL per le pipeline che preferiscono il formato Wavefront OBJ. La struttura del campo corrisponde all'oggetto model_urls di Immagine in 3D, in modo che future aggiunte di formati si integrino senza modifiche incompatibili.

URL scaricabile per l'immagine miniatura del file del modello.

Un array di oggetti URL delle texture generati da questo task. Attualmente contiene un singolo oggetto con la mappa del colore base.