Creative Lab — API Statuina

Foto originale che Meshy stilizzerà come statuina chibi. Attualmente supportiamo i formati .jpg, .jpeg, .png e .webp.

Ci sono due modi per fornire l'immagine:

• URL pubblicamente accessibile: Un URL accessibile da internet pubblico.
• 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 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, oppure supera il numero massimo di pixel.
• URL non raggiungibile: L'image_url non è stato possibile scaricarlo (404 o timeout).
• Data URI non valido: La stringa base64 è malformata.
• Contenuto segnalato: L'immagine di input è stata segnalata dalla moderation NSFW o per proprietà intellettuale.

L'autenticazione non è riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questo task.

Hai superato il tuo limite di frequenza.

L'ID dell'attività di un'attività 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à prototipo create tramite la webapp non sono accettate: l'endpoint di build accetta solo attività prototipo prodotte da POST /openapi/creative-lab/figure/v1/prototype e rifiuta qualsiasi altra origine con 404.

Nome facoltativo dell'attività per scopi 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.
• Task padre non completato: l'attività prototipo referenziata non ha ancora raggiunto lo stato SUCCEEDED.
• Nessun candidato: l'attività prototipo è stata completata con successo ma non ha prodotto alcuna immagine candidata.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

L'attività prototipo referenziata non esiste, appartiene a un utente diverso o è stata creata tramite la webapp (solo le attività prototipo in modalità API possono essere concatenate a una build).

Hai superato il tuo limite di frequenza.

Identificatore univoco del task di statuina da recuperare.

Identificatore univoco dell'attività di tipo statuina 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 del task di statuina da cui ricevere lo stream.

prototype o build. La raccolta restituisce solo le attività la cui fase corrisponde all'URL — recuperare /prototype non restituisce mai attività 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 del task. Sebbene per gli id dei task utilizziamo un UUID k-sortable come dettaglio implementativo, non dovresti fare alcuna assunzione sul formato dell'id.

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

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.

Avanzamento 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à 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. Consulta 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 i candidati dell'immagine concept generati da questo task di prototipazione. Attualmente l'API restituisce sempre esattamente un candidato; il campo è un array in modo che revisioni future possano fornire più candidati senza introdurre un breaking change.

Identificatore univoco del task.

Tipo del task. Il valore è creative-lab-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.

Progresso 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 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 figure build. Presente per compatibilità cross-endpoint con la struttura condivisa V2ImageTo3DTaskResponse utilizzata da Immagine in 3D.

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

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

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

URL scaricabili per il modello 3D generato. Il figure build produce un GLB con texture più la coppia OBJ + MTL per le pipeline che preferiscono il Wavefront OBJ. La forma 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.