Creative Lab Vinyl Figure API

La foto da trasformare in una vinyl figure dalla testa grande, come URL pubblico o come data URI (data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>).

L'immagine deve essere un file JPG, JPEG, PNG o WebP di al massimo 20 MB.

Un nome per l'attività, fino a 100 caratteri. Viene restituito nel campo name dell'attività. Un nome più lungo restituisce 400.

Se rimuovere lo sfondo dall'immagine di prototipo. true restituisce un PNG RGBA trasparente, così puoi posizionare il soggetto su qualsiasi sfondo. Anche la build parte dall'immagine senza il suo sfondo. Se Meshy non riesce a rimuovere lo sfondo, restituisce l'immagine con il suo sfondo, e l'attività ha comunque esito positivo.

La richiesta non può essere eseguita. Ad esempio:

• image_url manca.
• L'immagine non è un file JPG, JPEG, PNG o WebP.
• L'immagine è troppo piccola, supera i 20 MB, oppure supera il numero massimo di pixel.
• Meshy non riesce a scaricare l'immagine, ad esempio perché l'URL restituisce 404 o va in timeout.
• Il data URI non è una base64 valida.
• L'immagine è stata segnalata come NSFW.

Il messaggio di errore indica quale problema ha riscontrato. Correggi la richiesta, quindi inviala di nuovo.

La chiave API manca o non è valida. Controlla l'header Authorization.

Si applica uno di questi casi:

• L'account non ha crediti sufficienti.
• La chiave API, lo spazio di lavoro o il membro ha raggiunto il proprio limite di crediti.
• L'account è nel piano gratuito.

Controlla i tuoi crediti e il tuo piano, quindi riprova.

Il tuo team ha attivato il Filtraggio IP, e Meshy ha segnalato l'immagine per proprietà intellettuale di terzi. Invia un'immagine che hai il diritto di usare.

È stato raggiunto uno di questi limiti:

• Hai inviato più richieste di quante ne consenta il tuo limite di frequenza. Attendi qualche secondo, quindi riprova. Consulta Limiti di frequenza.
• Troppe delle tue attività sono in coda o in esecuzione. Attendi che alcune terminino, quindi riprova.
• Su un piano illimitato senza crediti rimanenti, hai raggiunto il numero di attività eseguibili senza crediti. Attendi che un'attività termini, oppure aggiungi crediti.

Meshy ha riscontrato un errore del server, ad esempio perché non è riuscita a eseguire il controllo della proprietà intellettuale sull'immagine. Meshy non crea l'attività e rimborsa eventuali crediti addebitati. Riprova la richiesta.

L'ID del task di prototipo da costruire. Deve essere un task creato dal tuo account con POST /openapi/creative-lab/vinyl-figure/v1/prototype, con stato SUCCEEDED.

Un ID che non corrisponde a uno dei tuoi task di prototipo Vinyl Figure dall'API restituisce 404, incluso un prototipo creato nell'app web.

Un nome per il task, fino a 100 caratteri. Viene restituito nel campo name del task. Un nome più lungo restituisce 400.

La richiesta non può essere eseguita. Ad esempio:

• input_task_id è mancante o non è un ID di task valido.
• Lo stato del task di prototipo non è SUCCEEDED. Se è ancora in esecuzione, attendi e riprova. Se è fallito o è stato annullato, crea un nuovo task di prototipo.
• Il task di prototipo è riuscito ma non ha alcuna immagine. Crea un nuovo task di prototipo.

Il messaggio di errore indica quale problema è stato rilevato.

La chiave API è mancante o non valida. Controlla l'header Authorization.

Si applica uno di questi casi:

• L'account non ha crediti sufficienti.
• La chiave API, lo spazio di lavoro o il membro ha raggiunto il proprio limite di crediti.
• L'account è su piano gratuito.

Controlla i tuoi crediti e il tuo piano, poi riprova.

input_task_id non corrisponde a nessun task di prototipo Vinyl Figure creato dal tuo account tramite l'API. Anche un prototipo creato nell'app web restituisce 404. Invia l'ID result ottenuto dalla risposta di creazione di un prototipo.

È stato raggiunto uno di questi limiti:

• Hai inviato più richieste di quante ne consenta il tuo limite di frequenza. Attendi qualche secondo, poi riprova. Vedi Limiti di frequenza.
• Troppi dei tuoi task sono in coda o in esecuzione. Attendi che alcuni si completino, poi riprova.
• Su un piano illimitato senza crediti residui, hai raggiunto il numero di task eseguibili senza crediti. Attendi che un task si completi, oppure aggiungi crediti.

L'ID dell'attività dalla risposta di creazione.

id non è un ID attività valido. Invia l'ID result dalla risposta di creazione.

Il tuo team ha il Filtro IP attivato e Meshy ha segnalato l'immagine dell'attività per proprietà intellettuale di terzi. I team con il piano Enterprise non ricevono questo errore. Crea un'attività di prototype da un'immagine su cui hai i diritti di utilizzo.

Nessuna attività Vinyl Figure con questo ID appartiene al tuo account, oppure la fase dell'attività non corrisponde al percorso. Controlla l'ID e usa /prototype o /build in base all'attività.

Meshy non è riuscito a eseguire il controllo sulla proprietà intellettuale. Riprova la richiesta.

L'ID dell'attività da annullare.

Si applica uno dei seguenti casi:

• id non è un ID attività valido. Invia l'ID result ottenuto dalla risposta di creazione.
• L'attività ha già uno stato finale (SUCCEEDED, FAILED o CANCELED), quindi non può essere annullata.

Nessuna attività Vinyl Figure con questo ID appartiene al tuo account, oppure la fase dell'attività non corrisponde al percorso. Controlla l'ID e usa /prototype o /build per far corrispondere l'attività.

L'ID del task dalla risposta di creazione.

La fase da elencare, prototype o build.

La pagina da restituire, da 1 a 255. 0 restituisce la prima pagina. Un valore al di fuori dell'intervallo 0-255 restituisce 400.

Numero di task per pagina, fino a 100. Un valore da 101 a 255 restituisce 100 task, e 0 usa il valore predefinito. Un valore al di fuori dell'intervallo 0-255 restituisce 400.

L'ordine di ordinamento.

Valori disponibili:

• -created_at: prima i più recenti
• +created_at: prima i più vecchi

L'ID del task. Non fare affidamento sul suo formato.

Il tipo di task, sempre creative-lab-vinyl-figure-prototype.

Il name inviato durante la creazione del task, oppure "" se non ne hai inviato uno.

Lo stato del task.

Valori disponibili:

• PENDING: in attesa in coda
• IN_PROGRESS: generazione del risultato in corso
• SUCCEEDED: finale, con il risultato
• FAILED: finale, con il motivo in task_error
• CANCELED: finale, senza risultato

Percentuale del lavoro completato, da 0 a 100. È 0 finché il task non inizia ed è 100 quando ha successo.

Momento di creazione del task, in millisecondi Unix.

Momento in cui un worker ha avviato il task, in millisecondi Unix. null fino ad allora.

Momento in cui il task ha raggiunto uno stato finale, in millisecondi Unix. null fino ad allora.

Momento in cui il risultato del task scade, in millisecondi Unix. È 3 giorni dopo finished_at, oppure 3 giorni dopo created_at finché il task non termina. Per gli account Enterprise, che conservano i risultati delle API a tempo indeterminato, è circa 100 anni dopo. Consulta Conservazione degli asset.

La posizione del task in coda mentre è PENDING. 1 significa che partirà come prossimo. 0 dopo che il task esce dalla coda, e sempre 0 nei risultati degli elenchi.

Il motivo per cui il task è fallito. null a meno che status non sia FAILED. Consulta Errori.

Numero di crediti addebitati per il task, dopo eventuali rimborsi. Una richiesta che restituisce un errore non viene addebitata. Un task fallito è 0, perché Meshy lo rimborsa. L'annullamento rimborsa un task solo mentre è PENDING. Se Meshy non riesce a leggere l'addebito, una risposta get o stream omette il campo, e una richiesta di elenco restituisce 500. In tal caso, riprova la richiesta.

URL di download per l'immagine concettuale. L'array contiene un URL dopo che il task ha successo, ed è vuoto fino ad allora.

L'ID del task. Non fare affidamento sul suo formato.

Il tipo di task, sempre creative-lab-vinyl-figure-build.

Il name inviato alla creazione del task, oppure "" se non ne hai inviato uno.

Lo stato del task.

Valori disponibili:

• PENDING: in attesa in coda
• IN_PROGRESS: generazione del risultato in corso
• SUCCEEDED: finale, con il risultato
• FAILED: finale, con il motivo in task_error
• CANCELED: finale, senza risultato

Percentuale di lavoro completato, da 0 a 100. È 0 finché il task non inizia e 100 quando ha successo.

Momento di creazione del task, in millisecondi Unix.

Momento in cui un worker ha avviato il task, in millisecondi Unix. null fino ad allora.

Momento in cui il task ha raggiunto uno stato finale, in millisecondi Unix. null fino ad allora.

Momento in cui il risultato del task scade, in millisecondi Unix. È 3 giorni dopo finished_at, oppure 3 giorni dopo created_at finché il task non termina. Per gli account Enterprise, che conservano i risultati delle API a tempo indeterminato, è circa 100 anni dopo. Vedi Conservazione degli asset.

La posizione del task in coda mentre è PENDING. 1 significa che inizierà come successivo. 0 dopo che il task lascia la coda, e sempre 0 nei risultati di lista.

Il motivo del fallimento del task. null a meno che status non sia FAILED. Vedi Errori.

Numero di crediti addebitati per il task, dopo eventuali rimborsi. Una richiesta che restituisce un errore non viene addebitata. Un task fallito è 0, perché Meshy lo rimborsa. L'annullamento rimborsa un task solo mentre è PENDING. Se Meshy non riesce a leggere l'addebito, una risposta get o stream omette il campo, e una richiesta di lista restituisce 500. In quel caso, riprova la richiesta.

Sempre "" per un task di build di statuina in vinile.

Sempre "" per un task di build di statuina in vinile, come prompt.

Sempre "" per un task di build di statuina in vinile, come prompt.

Sempre "" per un task di build di statuina in vinile, come prompt.

URL di download per il modello 3D, come GLB con texture e come file OBJ con il relativo file MTL.

URL di download per un'immagine di anteprima del modello.

Le mappe di texture, come un array con un singolo oggetto che contiene la mappa del colore base.