Creative Lab — API statuina in vinile

Foto sorgente che Meshy stilizzerà come statuina vinyl a testa grande. Al momento supportiamo i formati .jpg, .jpeg, .png e .webp.

Ci sono due modi per fornire l'immagine:

• URL pubblicamente accessibile: un URL accessibile da internet pubblicamente.
• Data URI: una data URI dell'immagine codificata in base64. Esempio di data URI: data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>.

Nome opzionale dell'attività, a scopo di visualizzazione. Massimo 100 caratteri.

Se impostato su true, l'immagine del prototipo viene restituita come PNG RGBA trasparente con lo sfondo rimosso, in modo da poter 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 irraggiungibile: l'image_url non è stato scaricabile (404 o timeout).
• Data URI non valida: la stringa base64 è malformata.
• Contenuto segnalato: l'immagine di input è stata segnalata dalla moderation per contenuti NSFW o per proprietà intellettuale.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

Hai superato il tuo limite di frequenza.

L'ID dell'attività di un'attività di prototipo creata 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.

Le attività di prototipo create tramite la webapp non sono accettate: l'endpoint di build accetta solo attività di prototipo prodotte da POST /openapi/creative-lab/vinyl-figure/v1/prototype e rifiuta qualsiasi altra origine con 404.

Nome facoltativo dell'attività a scopo di visualizzazione. Massimo 100 caratteri.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: input_task_id è obbligatorio.
• UUID non valido: input_task_id non è un UUID valido.
• Elemento padre non completato: l'attività di prototipo a cui si fa riferimento non ha ancora raggiunto lo stato SUCCEEDED.
• Nessun candidato: l'attività di prototipo è stata completata con successo ma non ha prodotto alcuna immagine candidata.

Autenticazione non riuscita. Verifica la tua chiave API.

Crediti insufficienti per eseguire questa attività.

L'attività di prototipo a cui si fa riferimento non esiste, appartiene a un altro utente oppure è stata creata tramite la webapp (solo le attività di prototipo in modalità API possono essere concatenate a una build).

Hai superato il limite di frequenza.

Identificatore univoco dell'attività vinyl figure da recuperare.

Identificatore univoco dell'attività vinyl figure da annullare.

L'attività si trova già in uno stato terminale e non può essere annullata.

L'attività non esiste, appartiene a un altro utente, oppure la sua fase non corrisponde al percorso dell'URL.

Identificatore univoco dell'attività di statuina in vinile da trasmettere in streaming.

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

Numero di pagina per la paginazione.

Limite della dimensione della pagina. Il massimo consentito è 100 elementi.

Campo per l'ordinamento. Valori disponibili:

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

Identificatore univoco per il task. Sebbene utilizziamo un UUID k-sortable per gli id dei task come dettaglio implementativo, non dovresti fare alcuna assunzione sul formato dell'id.

Tipo del task. Il valore è creative-lab-vinyl-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 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 ha avuto successo, 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à 0.

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

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

Il conteggio dei task precedenti.

Dettagli dell'errore per i task falliti. Vedi Errori per il riferimento completo dell'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 le candidate dell'immagine concettuale generate da questo task di prototipo. Attualmente l'API restituisce sempre esattamente una candidata; il campo è un array in modo che revisioni future possano esporre più candidate senza modifiche incompatibili.

Identificatore univoco del task.

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

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

Stato del task. I possibili valori 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 ha avuto successo, 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 conteggio dei task precedenti. Significativo solo quando lo stato è 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 la costruzione della statuina vinile. Presente per compatibilità cross-endpoint con la struttura condivisa V2ImageTo3DTaskResponse usata da Immagine in 3D.

Sempre vuoto per la costruzione della statuina vinile. Presente per compatibilità cross-endpoint.

Sempre vuoto per la costruzione della statuina vinile. Presente per compatibilità cross-endpoint.

Sempre vuoto per la costruzione della statuina vinile. Presente per compatibilità cross-endpoint.

URL scaricabili per il modello 3D generato. La costruzione della statuina vinile produce un GLB texturizzato più la coppia OBJ + MTL per le pipeline che preferiscono Wavefront OBJ. La forma del campo corrisponde all'oggetto model_urls di Immagine in 3D, così eventuali future aggiunte di formati si integrano senza modifiche incompatibili.

URL scaricabile dell'immagine miniatura del file modello.

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