Creative Lab — API Statuina

Foto sorgente che Meshy deve stilizzare come una statuina in mattoncini. 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 codificato in base64 dell'immagine. Esempio di un Data URI: data:image/jpeg;base64,<your base64-encoded image data>.

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

Quando impostato su true, l'immagine prototipo viene restituita come un PNG RGBA trasparente con lo sfondo rimosso, in modo da poter comporre il soggetto su qualsiasi sfondo.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: image_url è richiesto.
• Formato immagine non valido: L'image_url fornito non è un formato supportato (.jpg, .jpeg, .png, .webp).
• Dimensioni immagine fuori intervallo: L'immagine è troppo piccola, supera la dimensione massima del file o supera il conteggio massimo di pixel.
• URL irraggiungibile: L'image_url non può essere scaricato (404 o timeout).
• Data URI non valido: La stringa base64 è malformata.
• Contenuto segnalato: L'immagine di input è stata segnalata dalla moderation NSFW.

Autenticazione fallita. Si prega di controllare la tua chiave API.

Crediti insufficienti per eseguire questo task.

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

Hai superato il tuo limite di frequenza.

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

I task prototipo creati tramite l'app web non sono accettati — l'endpoint di costruzione accetta solo task prototipo prodotti da POST /openapi/creative-lab/brick-figure/v1/prototype e rifiuta qualsiasi altra fonte con 404.

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

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: input_task_id è richiesto.
• UUID non valido: L'input_task_id non è un UUID valido.
• Genitore non riuscito: Il task prototipo di riferimento non ha ancora raggiunto SUCCEEDED.
• Nessun candidato: Il task prototipo è riuscito ma non ha prodotto alcuna immagine candidata.

Autenticazione fallita. Si prega di controllare la tua chiave API.

Crediti insufficienti per eseguire questo task.

Il task prototipo di riferimento non esiste, appartiene a un altro utente o è stato creato tramite l'app web (solo i task prototipo in modalità API si concatenano nella costruzione).

Hai superato il tuo limite di frequenza.

Identificatore univoco per il compito di statuina da recuperare.

Identificatore univoco per l'attività di statuina di mattoni da annullare.

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

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

Identificatore univoco per l'attività di statuina a mattoncini da trasmettere.

O prototype o build. La raccolta restituisce solo le attività la cui fase corrisponde all'URL — recuperare /prototype non restituisce mai attività di costruzione e viceversa.

Numero di pagina per la paginazione.

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

Campo per l'ordinamento. Valori disponibili:

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

Identificatore univoco per il task. Anche se utilizziamo un UUID ordinabile per id dei task come dettaglio di implementazione, non dovresti fare alcuna supposizione sul formato dell'id.

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

Il nome del task fornito quando il task è stato creato. Stringa vuota se non è stato fornito alcun nome.

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

Avanzamento 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. Se il task non è ancora iniziato, questa proprietà sarà null.

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

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

Il conteggio dei task precedenti.

Dettagli degli errori per i task falliti. Vedi 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 all'immagine concettuale generati da questo task prototipo. Attualmente l'API restituisce sempre esattamente un candidato; il campo è un array in modo che le revisioni future possano mostrare più candidati senza una modifica dirompente.

Identificatore univoco per il task.

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

Il nome del task fornito quando il task è stato creato. Stringa vuota se non è stato fornito alcun nome.

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

Progresso 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 conteggio dei task precedenti. Significativo solo quando lo stato è PENDING.

Dettagli degli errori per i task falliti. Vedi Errori per il riferimento completo all'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 di mattoni. Presente per la compatibilità tra endpoint con la forma condivisa V2ImageTo3DTaskResponse usata da Immagine in 3D.

Sempre vuoto per la costruzione della statuina di mattoni. Presente per la compatibilità tra endpoint.

Sempre vuoto per la costruzione della statuina di mattoni. Presente per la compatibilità tra endpoint.

Sempre vuoto per la costruzione della statuina di mattoni. Presente per la compatibilità tra endpoint.

URL scaricabili per il modello 3D generato. La costruzione della statuina di mattoni emette un GLB texturizzato più la coppia OBJ + MTL per pipeline che preferiscono Wavefront OBJ. La forma del campo corrisponde all'oggetto model_urls Immagine in 3D in modo che le aggiunte di formato future si inseriscano senza un cambiamento radicale.

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

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