Creative Lab — API Fidget Pixel

Foto sorgente che Meshy dovrà pixelizzare. Attualmente supportiamo i formati .jpg, .jpeg, .png e .webp.

Il formato viene rilevato decodificando i dati dell'immagine, non dall'estensione del file nell'URL — un URL senza estensione, o uno che reindirizza, funziona purché i byte vengano decodificati in un formato supportato. I reindirizzamenti HTTP vengono seguiti.

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

Cosa mostra la foto. Seleziona lo stile di pixelizzazione, quindi scegli con attenzione — i due producono risultati visibilmente diversi. Valori disponibili:

• person — il soggetto è una persona (ritratto o corpo intero). Produce uno sprite pixel in stile chibi del soggetto.
• other — qualsiasi altra cosa: animali domestici, oggetti, mascotte, loghi, paesaggi. Produce un'icona pixel in stile bead-art del soggetto.

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

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: sono richiesti sia image_url che type.
• Tipo non valido: type deve essere person o other.
• 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 consentito.
• URL non raggiungibile: non è stato possibile scaricare image_url (404 o timeout).
• Data URI non valido: la stringa base64 è malformata.
• Contenuto segnalato: l'immagine in input è stata segnalata dalla moderation NSFW.

Autenticazione fallita. Verifica la tua chiave API.

Crediti insufficienti per eseguire questo task, oppure la chiave API appartiene a un account con piano gratuito.

L'immagine in input è stata segnalata dalla moderation sulla proprietà intellettuale (Content flagged for intellectual property violation). Vengono bloccati solo gli account Enterprise con il filtro sulla proprietà intellettuale attivo; non viene addebitato nulla.

Hai superato il tuo limite di frequenza.

Non è stato possibile completare il controllo sulla proprietà intellettuale (Unable to perform intellectual property check, please try again). Gli account Enterprise con il filtro sulla proprietà intellettuale attivo falliscono in modalità chiusa su questo controllo; non viene addebitato nulla — riprova la richiesta.

L'ID dell'attività di un'attività di prototipo creata tramite lo stesso endpoint OpenAPI. Il prototipo deve essere stato creato dallo stesso account Meshy e deve aver raggiunto SUCCEEDED.

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/fidget-pixel/v1/prototype e rifiuta qualsiasi altra origine con 404.

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

Ingombro di ciascun pezzo. Valori disponibili:

• square (predefinito) — pezzi quadrati su una griglia quadrata.
• hex — pezzi esagonali su una griglia esagonale. I pezzi esagonali sono disponibili solo in 6 e 8 mm.

Numero di pezzi lungo ciascun lato della tavola. Valori disponibili: 16 o 32. Una griglia 32 conserva più dettaglio; una griglia 16 significa pezzi meno numerosi e più grandi per lo stesso soggetto.

Lunghezza del lato di ciascun pezzo, in millimetri. Valori disponibili: 6, 8 o 10. Insieme a grid_size questo determina la dimensione stampata della tavola — ad esempio 32 × 8 mm ≈ 26 cm per lato. 10 non è disponibile per shape: "hex" (la faccia esagonale inclinata presenta sbalzi sulla maggior parte delle stampanti FDM consumer).

Numero massimo di colori nella palette a cui viene quantizzata l'immagine. Intervallo: [1, 8]. Ogni colore diventa un filamento nel tuo slicer.

Altezza di ciascun pezzo, in millimetri. Intervallo: [10, 80].

Artefatto restituito dal build. Valori disponibili:

• 3mf (predefinito) — restituisce un singolo model.3mf sotto model_urls.3mf, con un oggetto per pezzo e il colore del pezzo associato a ciascun oggetto.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: input_task_id è obbligatorio.
• UUID non valido: input_task_id non è un UUID valido.
• Genitore non riuscito: l'attività di prototipo referenziata non ha ancora raggiunto SUCCEEDED.
• Nessun candidato: l'attività di prototipo è riuscita ma non ha prodotto alcuna immagine pixel-art; crea un nuovo prototipo.
• Opzioni fuori intervallo: uno dei campi di options è al di fuori del suo insieme o intervallo consentito — ad esempio options.grid_size must be 16 or 32, oppure options.piece_size_mm=10 is not supported for shape=hex; hex pieces are available in 6 and 8 mm.
• Formato non supportato: output.format deve essere 3mf.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività, oppure la chiave API appartiene a un account con piano gratuito.

L'immagine del prototipo referenziato è stata segnalata dalla moderation sulla proprietà intellettuale. Vengono bloccati solo gli account Enterprise con il filtro sulla proprietà intellettuale abilitato; non viene addebitato nulla.

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

Hai superato il tuo limite di frequenza.

Non è stato possibile stabilire il verdetto sulla proprietà intellettuale del prototipo referenziato (Unable to perform intellectual property check, please try again). Gli account Enterprise con il filtro sulla proprietà intellettuale abilitato falliscono in modo bloccante su questo controllo; non viene addebitato nulla — riprova la richiesta.

Identificatore univoco del task fidget pixel da recuperare.

id non è un UUID valido (Invalid ID).

L'immagine del task è stata segnalata dalla moderazione della proprietà intellettuale. Vengono bloccati solo gli account Enterprise con il filtro della proprietà intellettuale abilitato.

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

Non è stato possibile completare il controllo della proprietà intellettuale (Unable to perform intellectual property check, please try again); gli account Enterprise con il filtro della proprietà intellettuale abilitato falliscono in modalità restrittiva. Riprova la richiesta.

Identificatore univoco dell'attività fidget pixel da annullare.

La richiesta non era accettabile. Cause comuni:

• ID non valido: id non è un UUID valido.
• Stato terminale: l'attività è già SUCCEEDED, FAILED o CANCELED e non può essere annullata.

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

Identificatore univoco dell'attività fidget pixel di cui effettuare lo streaming.

prototype oppure 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 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 come dettaglio implementativo utilizziamo un UUID k-sortable per gli id dei task, non dovresti fare alcuna assunzione sul formato dell'id.

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

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

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

Timestamp di quando il risultato del task scade, in millisecondi — 3 giorni dopo il termine del task. Gli account Enterprise conservano i risultati API a tempo indeterminato (vedi Conservazione degli asset); per loro questo timestamp è impostato a circa 100 anni nel futuro.

Il conteggio dei task precedenti.

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

Il numero di crediti consumati da questo task. Un task che raggiunge SUCCEEDED viene addebitato per l'intero importo della sua fase. Un task che non viene mai creato (un 4xx al momento della richiesta, incluso un rifiuto di moderation) non viene addebitato affatto. Un task che raggiunge FAILED restituisce 0 — l'addebito viene rimborsato. Annullare tramite DELETE rimborsa solo mentre il task è ancora PENDING; un task già IN_PROGRESS rimane addebitato, perché il lavoro è già stato svolto.

URL scaricabili per l'immagine pixel-art generata da questo task di prototipo. Attualmente l'API restituisce sempre esattamente un'immagine; il campo è un array in modo che revisioni future possano esporre più candidati senza una modifica non retrocompatibile. Vuoto finché il task non raggiunge SUCCEEDED.

Questi sono URL firmati: recuperali senza un header Authorization. Rimangono validi fino a expires_at, che è 3 giorni dopo finished_at, e rileggere il task all'interno di quella finestra restituisce l'URL identico anziché uno appena firmato. Scarica e archivia tu stesso i file prima di allora — non c'è modo di aggiornare un link scaduto.

Identificatore univoco per il task.

Tipo del task. Il valore è creative-lab-fidget-pixel-build.

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.

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. null finché il task non inizia.

Timestamp di quando il task è terminato, in millisecondi. null finché il task non termina.

Timestamp di quando il risultato del task scade, in millisecondi — 3 giorni dopo il termine del task. Gli account Enterprise conservano i risultati API a tempo indeterminato (vedi Asset Retention); per loro questo timestamp è impostato a circa 100 anni di distanza.

Il conteggio dei task precedenti. Significativo solo quando lo status è PENDING.

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. Un task che raggiunge SUCCEEDED viene addebitato dell'intero importo per la sua fase. Un task che non viene mai creato (un 4xx al momento della richiesta, incluso un rifiuto di moderation) non viene affatto addebitato. Un task che raggiunge FAILED restituisce 0 — l'addebito viene rimborsato. L'annullamento tramite DELETE rimborsa solo mentre il task è ancora PENDING; un task già IN_PROGRESS rimane addebitato, poiché il lavoro è già stato speso.

URL scaricabili per l'artefatto generato, indicizzati per formato. Contiene esattamente una voce — il formato richiesto tramite output.format della richiesta di build. Vuoto finché il task non raggiunge SUCCEEDED.

Questi sono URL firmati: recuperali senza un header Authorization. Rimangono validi fino a expires_at, che corrisponde a 3 giorni dopo finished_at, e rileggere il task all'interno di questa finestra temporale restituisce lo stesso URL identico piuttosto che uno appena firmato. Scarica e conserva tu stesso i file prima di allora — non c'è modo di rinnovare un link scaduto.